Share via

Windows Media Player 11 SDK IWMPSubscriptionService2::deviceAvailable 

  • Article

Windows Media Player SDK banner art

Previous Next

IWMPSubscriptionService2::deviceAvailable

Note This section describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.

The deviceAvailable method is implemented by the online store to initiate device-specific processing tasks.

Syntax

  HRESULT deviceAvailable(
  BSTR  bstrDeviceName,
  IWMPSubscriptionServiceCallback*  pCB
);

Parameters

bstrDeviceName

String containing the device name.

pCB

Pointer to an IWMPSubscriptionServiceCallback interface. The online store uses this pointer to notify Windows Media Player that device-specific processing is complete.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

Windows Media Player calls this method after a synchronization operation if the time elapsed since the last call is one week or more.

Your code should not perform lengthy operations synchronously when Windows Media Player calls this method. Instead, you must perform device-specific processing tasks on a separate worker thread.

The string contained in bstrDeviceName is not the same name retrieved by using IWMPSyncDevice::deviceName. Rather, it is the canonical name retrieved by using the IWMDMDevice2::GetCanonicalName method provided by the Windows Media Device Manager SDK.

You must call IWMPSubscriptionServiceCallback::onComplete from same thread on which deviceAvailable was called.

Requirements

Version: Windows Media Player 10 or later.

Header: Defined in subscriptionservices.h.

See Also

Previous Next