Método IWMDRMDeviceApp2::QueryDeviceStatus2

El método QueryDeviceStatus2 consulta un dispositivo para obtener un estado o funcionalidad de DRM específico.

Sintaxis

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

Parámetros

pDevice [in]

Puntero a un objeto IWMDMDevice .

dwFlags [in]

Uno o varios de los siguientes valores DWORD que especifican qué funcionalidades solicitar, combinadas con un OR bit a bit.

Marca	Descripción
WMDRM_QUERY_CLIENT_INDIVSTATUS	Consulte si los componentes drm del equipo deben individualizarse.
WMDRM_QUERY_DEVICE_CLOCKSTATUS	Consulte si el reloj seguro del dispositivo debe agregarse o actualizarse.
WMDRM_QUERY_DEVICE_ISREVOKED	Consulte si se revoca el dispositivo.
WMDRM_QUERY_DEVICE_ISWMDRM	Consulta si el dispositivo admite DRM 10 de Windows Media para dispositivos portátiles.

pdwStatus [out]

Cero o más de los siguientes valores DWORD que especifican el estado del dispositivo solicitado, combinado con un OR bit a bit.

Estado	Descripción
WMDRM_DEVICE_ISWMDRM	El dispositivo admite DRM de Windows Media.
WMDRM_DEVICE_NEEDCLOCK	El dispositivo no tiene un reloj seguro.
WMDRM_DEVICE_REVOKED	Se ha revocado el dispositivo.
WMDRM_CLIENT_NEEDINDIV	Los componentes drm del equipo deben individualizarse.
WMDRM_DEVICE_REFRESHCLOCK	El reloj debe actualizarse.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
DRM_E_INVALIDARG	Uno o varios argumentos no son válidos.
NS_E_DRM_INVALID_CERTIFICATE	El certificado de dispositivo recuperado del dispositivo no es válido.
NS_E_DRM_UNABLE_TO_GET_DEVICE_CERT	No se pudo recuperar el certificado de dispositivo del dispositivo.

Comentarios

Se debe llamar a este método antes de realizar acciones restringidas en el contenido drm, como transferir contenido DRM al dispositivo o adquirir información de medición. Si los valores recuperados por pdwStatus indican que es necesario realizar alguna acción (como la individualización para el escritorio o adquirir un reloj para el dispositivo), la aplicación debe llamar a IWMDRMDeviceApp::AcquireDeviceData y pasar el valor pdwStatus recuperado de esta función al parámetro dwFlags en AcquireDeviceData. Si se devuelve cero, el dispositivo no admite DRM 10 de Windows Media para dispositivos portátiles y no es necesario realizar ninguna acción. Consulte Control de contenido protegido en la aplicación para obtener más información.

Requisitos

Requisito	Value
Encabezado	WMDRMDeviceApp.h (también requiere Wmdrmdeviceapp_i.c, compilado a partir de WMDRMDeviceApp.idl)
Biblioteca	Mssachlp.lib

Consulte también

Control del contenido protegido en la aplicación

IWMDRMDeviceApp::QueryDeviceStatus

IWMDRMDeviceApp2 (Interfaz)