IWMDRMDeviceApp2::QueryDeviceStatus2 method

Article
03/22/2021

The QueryDeviceStatus2 method queries a device for a specific DRM status or capability.

Syntax

HRESULT QueryDeviceStatus2(
  [in]  IWMDMDevice *pDevice,
  [in]  DWORD       dwFlags,
  [out] DWORD       *pdwStatus
);

Parameters

pDevice [in]

Pointer to an IWMDMDevice object.

dwFlags [in]

One or more of the following DWORD values specifying which capabilities to request, combined with a bitwise OR.

Flag	Description
WMDRM_QUERY_CLIENT_INDIVSTATUS	Query whether the computer's DRM components need to be individualized.
WMDRM_QUERY_DEVICE_CLOCKSTATUS	Query whether the device's secure clock needs to be added or updated.
WMDRM_QUERY_DEVICE_ISREVOKED	Query whether the device is revoked.
WMDRM_QUERY_DEVICE_ISWMDRM	Query whether the device supports Windows Media DRM 10 for Portable Devices.

pdwStatus [out]

Zero or more of the following DWORD values specifying the requested device status, combined with a bitwise OR.

Status	Description
WMDRM_DEVICE_ISWMDRM	The device supports Windows Media DRM.
WMDRM_DEVICE_NEEDCLOCK	The device does not have a secure clock.
WMDRM_DEVICE_REVOKED	The device has been revoked.
WMDRM_CLIENT_NEEDINDIV	The computer's DRM components need to be individualized.
WMDRM_DEVICE_REFRESHCLOCK	The clock needs to be refreshed.

Return value

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.
DRM_E_INVALIDARG	One or more arguments are not valid.
NS_E_DRM_INVALID_CERTIFICATE	The device certificate retrieved from the device is not valid.
NS_E_DRM_UNABLE_TO_GET_DEVICE_CERT	Failed to retrieve the device certificate from the device.

Remarks

This method should be called before performing any restricted actions on DRM content, such as transferring DRM content to the device, or acquiring metering information. If the values retrieved by pdwStatus indicate that some action needs to be performed (such as individualization for the desktop or acquiring a clock for the device), the application should call IWMDRMDeviceApp::AcquireDeviceData and pass in the retrieved pdwStatus value from this function to the dwFlags parameter in AcquireDeviceData. If zero is returned, the device does not support Windows Media DRM 10 for Portable Devices, and no actions need be taken. See Handling Protected Content in the Application for more information.

Requirements

Requirement	Value
Header	WMDRMDeviceApp.h (also requires Wmdrmdeviceapp_i.c, built from WMDRMDeviceApp.idl)
Library	Mssachlp.lib