IWMDRMDeviceApp::AcquireDeviceData method
The AcquireDeviceData method initializes or resets a device secure clock.
Syntax
HRESULT AcquireDeviceData(
[in] IWMDMDevice *pDevice,
[in] IWMDMProgress3 *pProgressCallback,
[in] DWORD dwFlags,
[out] DWORD *pdwStatus
);
Parameters
-
pDevice [in]
-
Pointer to an IWMDMDevice interface for the device that will report metering data.
-
pProgressCallback [in]
-
Progress callback through which the application can track the progress of the event, or cancel the event. The progress is identified by the EventId parameter of IWMDMProgress3 methods.
-
dwFlags [in]
-
A logical OR of one or both of the following flags, specifying what action to perform. This value is retrieved from the pdwStatus parameter of IWMDRMDeviceApp::QueryDeviceStatus or IWMDRMDeviceApp2::QueryDeviceStatus2. You can use the pdwStatus flag directly.
Flag Description WMDRM_DEVICE_NEEDCLOCK Acquire a clock from a secure clock server. WMDRM_DEVICE_REFRESHCLOCK Refresh the clock from a secure clock server. -
pdwStatus [out]
-
One of the following DWORD values specifying the status returned by the device.
Status Description 0 The action is not supported. 1 The device secure clock could not be acquired from the service. 2 The device's secure clock could not be set. 3 The device's secure clock was set.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
One or more arguments are not valid. |
|
The specified device is not a Windows Media DRM compatible device. |
|
Failed to retrieve secure clock challenge from the device or unable to retrieve the secure clock URL from the challenge. |
|
Failed to retrieve the secure clock response from the secure clock server. |
|
Failed to send the secure clock challenge to the device, or the device failed to set the clock. |
Remarks
This is an asynchronous method; the device must await the IWMDMProgress::End callback for this operation before attempting to play any licensed content.
An application can learn if the device must have its clock reset or updated by calling IWMDRMDeviceApp::QueryDeviceStatus or IWMDRMDeviceApp2::QueryDeviceStatus2.
Your application must have an Internet connection to enable it to acquire or reset a secure clock.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|