IWMDRMDeviceApp::AcquireDeviceData (método)
El método AcquireDeviceData inicializa o restablece un reloj seguro del dispositivo.
Sintaxis
HRESULT AcquireDeviceData(
[in] IWMDMDevice *pDevice,
[in] IWMDMProgress3 *pProgressCallback,
[in] DWORD dwFlags,
[out] DWORD *pdwStatus
);
Parámetros
-
pDevice [in]
-
Puntero a una interfaz IWMDMDevice para el dispositivo que notificará los datos de medición.
-
pProgressCallback [in]
-
Devolución de llamada de progreso a través de la cual la aplicación puede realizar un seguimiento del progreso del evento o cancelar el evento. El progreso se identifica mediante el parámetro EventId de los métodos IWMDMProgress3 .
-
dwFlags [in]
-
Or lógico de una o ambas marcas siguientes, especificando qué acción se va a realizar. Este valor se recupera del parámetro pdwStatus de IWMDRMDeviceApp::QueryDeviceStatus o IWMDRMDeviceApp2::QueryDeviceStatus2. Puede usar la marca pdwStatus directamente.
Marca Descripción WMDRM_DEVICE_NEEDCLOCK Adquiera un reloj de un servidor de reloj seguro. WMDRM_DEVICE_REFRESHCLOCK Actualice el reloj desde un servidor de reloj seguro. -
pdwStatus [out]
-
Uno de los siguientes valores DWORD especificando el estado devuelto por el dispositivo.
Estado Descripción 0 No se admite la acción. 1 No se pudo adquirir el reloj seguro del dispositivo desde el servicio. 2 No se pudo establecer el reloj seguro del dispositivo. 3 Se estableció el reloj seguro del dispositivo.
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 |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
Uno o varios argumentos no son válidos. |
|
El dispositivo especificado no es un dispositivo compatible con DRM de Windows Media. |
|
No se pudo recuperar el desafío de reloj seguro del dispositivo o no se pudo recuperar la dirección URL del reloj seguro del desafío. |
|
No se pudo recuperar la respuesta de reloj segura del servidor de reloj seguro. |
|
No se pudo enviar el desafío de reloj seguro al dispositivo o el dispositivo no pudo establecer el reloj. |
Comentarios
Se trata de un método asincrónico; El dispositivo debe esperar la devolución de llamada IWMDMProgress::End para esta operación antes de intentar reproducir cualquier contenido con licencia.
Una aplicación puede aprender si el dispositivo debe tener el restablecimiento del reloj o actualizar llamando a IWMDRMDeviceApp::QueryDeviceStatus o IWMDRMDeviceApp2::QueryDeviceStatus2.
La aplicación debe tener una conexión a Internet para permitir que adquiera o restablezca un reloj seguro.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|