IWMDRMDeviceApp::QueryDeviceStatus (Método)

El método QueryDeviceStatus consulta un dispositivo para conocer su estado y funcionalidades actuales de DRM.

Sintaxis

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

Parámetros

pDevice [in]

Puntero a un objeto IWMDMDevice .

pdwStatus [out]

Cero o más de los siguientes valores DWORD que describen los aspectos drm del dispositivo, combinados con un OR bit a bit. Vea la sección Comentarios.

Status Descripción
WMDRM_DEVICE_ISWMDRM El dispositivo admite Windows DRM multimedia.
WMDRM_DEVICE_NEEDCLOCK El dispositivo no tiene un reloj seguro.
WMDRM_DEVICE_REVOKED Se ha revocado el dispositivo.
WMDRM_CLIENT_NEEDINDIV La seguridad drm debe 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
El argumento input no es válido.
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 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 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 Windows DRM 10 multimedia 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.

Ejemplos

En el siguiente ejemplo de código de C++ se crea un objeto WMDRMDeviceApp, se comprueba que el dispositivo es un dispositivo Windows DRM 10 multimedia, que su reloj es preciso y, a continuación, solicita los datos de medición.

HRESULT hr = S_OK;
// Create the WMDRMDeviceApp object.
CComPtr<IWMDRMDeviceApp> pDRM;
hr = pDRM.CoCreateInstance(CLSID_WMDRMDeviceApp, 0, CLSCTX_ALL);

// Find out first if the device is a WMDRM 10 device, and if it requires
// any clock updates.
DWORD status = 0;
hr = pDRM->QueryDeviceStatus(pDevice, &status);

if (!(WMDRM_DEVICE_ISWMDRM & status)) // Device is not WMDRM 10. Nothing can be updated,
    return E_FAIL;                   // and metering cannot be performed.
else if (status & WMDRM_DEVICE_REVOKED) // Device is revoked.
    return E_FAIL;
else if (status & WMDRM_DEVICE_NEEDCLOCK || 
    status & WMDRM_CLIENT_NEEDINDIV ||
    status & WMDRM_DEVICE_REFRESHCLOCK)
{
    // Need to update device clock. 
    // Using custom function, which is synchronous.
    hr = myAcquireDeviceData(pDRM, pDevice, this, status, &result);
    if (hr != S_OK || result != 0)    // Couldn't perform the updates.
        return E_FAIL;    
}

Requisitos

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

Vea también

Control del contenido protegido en la aplicación

IWMDRMDeviceApp (Interfaz)

IWMDRMDeviceApp2::QueryDeviceStatus2