Método IWMDRMDeviceApp2::QueryDeviceStatus2
O método QueryDeviceStatus2 consulta um dispositivo para obter uma status ou funcionalidade específica do DRM.
Sintaxe
HRESULT QueryDeviceStatus2(
[in] IWMDMDevice *pDevice,
[in] DWORD dwFlags,
[out] DWORD *pdwStatus
);
Parâmetros
-
pDevice [in]
-
Ponteiro para um objeto IWMDMDevice .
-
dwFlags [in]
-
Um ou mais dos seguintes valores DWORD especificando quais recursos solicitar, combinados com um OR bit a bit.
Sinalizador Descrição WMDRM_QUERY_CLIENT_INDIVSTATUS Consulte se os componentes drm do computador precisam ser individualizados. WMDRM_QUERY_DEVICE_CLOCKSTATUS Consulte se o relógio seguro do dispositivo precisa ser adicionado ou atualizado. WMDRM_QUERY_DEVICE_ISREVOKED Consulte se o dispositivo foi revogado. WMDRM_QUERY_DEVICE_ISWMDRM Consulte se o dispositivo dá suporte ao WINDOWS Media DRM 10 para dispositivos portáteis. -
pdwStatus [out]
-
Zero ou mais dos seguintes valores DWORD que especificam o dispositivo solicitado status, combinado com um OR bit a bit.
Status Descrição WMDRM_DEVICE_ISWMDRM O dispositivo dá suporte ao DRM do Windows Media. WMDRM_DEVICE_NEEDCLOCK O dispositivo não tem um relógio seguro. WMDRM_DEVICE_REVOKED O dispositivo foi revogado. WMDRM_CLIENT_NEEDINDIV Os componentes drm do computador precisam ser individualizados. WMDRM_DEVICE_REFRESHCLOCK O relógio precisa ser atualizado.
Valor retornado
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Um ou mais argumentos não são válidos. |
|
O certificado do dispositivo recuperado do dispositivo não é válido. |
|
Falha ao recuperar o certificado do dispositivo do dispositivo. |
Comentários
Esse método deve ser chamado antes de executar qualquer ação restrita no conteúdo drm, como transferir conteúdo DRM para o dispositivo ou adquirir informações de medição. Se os valores recuperados por pdwStatus indicarem que alguma ação precisa ser executada (como individualização para a área de trabalho ou aquisição de um relógio para o dispositivo), o aplicativo deve chamar IWMDRMDeviceApp::AcquireDeviceData e passar o valor de pdwStatus recuperado dessa função para o parâmetro dwFlags em AcquireDeviceData. Se zero for retornado, o dispositivo não oferecerá suporte ao DRM 10 do Windows Media para Dispositivos Portáteis e nenhuma ação precisará ser executada. Consulte Manipulando conteúdo protegido no aplicativo para obter mais informações.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|