Compartilhar via

Método IWMDRMDeviceApp2::QueryDeviceStatus2

  • Artigo

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
S_OK
 O método foi bem-sucedido.
DRM_E_INVALIDARG
 Um ou mais argumentos não são válidos.
NS_E_DRM_INVALID_CERTIFICATE
 O certificado do dispositivo recuperado do dispositivo não é válido.
NS_E_DRM_UNABLE_TO_GET_DEVICE_CERT
 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
WMDRMDeviceApp.h (também requer Wmdrmdeviceapp_i.c, criado a partir de WMDRMDeviceApp.idl)
Biblioteca
Mssachlp.lib

Confira também

Manipulando conteúdo protegido no aplicativo

IWMDRMDeviceApp::QueryDeviceStatus

IWMDRMDeviceApp2 Interface