Поделиться через

Метод IWMDRMDeviceApp2::QueryDeviceStatus2

  • Статья

Метод QueryDeviceStatus2 запрашивает у устройства определенное состояние или возможность DRM.

Синтаксис

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

Параметры

pDevice [in]

Указатель на объект IWMDMDevice .

dwFlags [in]

Одно или несколько из следующих значений DWORD , указывающих, какие возможности следует запрашивать, в сочетании с побитовой или.

Flag Описание
WMDRM_QUERY_CLIENT_INDIVSTATUS Запросите необходимость индивидуализации компонентов DRM компьютера.
WMDRM_QUERY_DEVICE_CLOCKSTATUS Запросите, нужно ли добавлять или обновлять защищенные часы устройства.
WMDRM_QUERY_DEVICE_ISREVOKED Запрос на отзыв устройства.
WMDRM_QUERY_DEVICE_ISWMDRM Запросите, поддерживает ли устройство WINDOWS Media DRM 10 для переносных устройств.

pdwStatus [out]

Ноль или более из следующих значений DWORD , указывающих состояние запрошенного устройства, в сочетании с побитовой ИЛИ.

Состояние Описание
WMDRM_DEVICE_ISWMDRM Устройство поддерживает Windows Media DRM.
WMDRM_DEVICE_NEEDCLOCK Устройство не имеет защищенных часов.
WMDRM_DEVICE_REVOKED Устройство отозвано.
WMDRM_CLIENT_NEEDINDIV Компоненты DRM компьютера должны быть индивидуализированы.
WMDRM_DEVICE_REFRESHCLOCK Часы необходимо обновить.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
DRM_E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
NS_E_DRM_INVALID_CERTIFICATE
 Сертификат устройства, полученный с устройства, является недопустимым.
NS_E_DRM_UNABLE_TO_GET_DEVICE_CERT
 Не удалось получить сертификат устройства с устройства.

Комментарии

Этот метод следует вызывать перед выполнением каких-либо ограниченных действий с содержимым DRM, таких как передача содержимого DRM на устройство или получение сведений о измерении. Если значения, полученные pdwStatus , указывают на то, что необходимо выполнить какое-либо действие (например, индивидуализация рабочего стола или получение часов для устройства), приложение должно вызвать IWMDRMDeviceApp::AcquireDeviceData и передать полученное значение pdwStatus из этой функции в параметр dwFlags в AcquireDeviceData. Если возвращается ноль, устройство не поддерживает Windows Media DRM 10 для переносных устройств и не требует никаких действий. Дополнительные сведения см. в разделе Обработка защищенного содержимого в приложении .

Требования

Требование Значение
Заголовок
WMDRMDeviceApp.h (также требуется Wmdrmdeviceapp_i.c, созданный на основе WMDRMDeviceApp.idl)
Библиотека
Mssachlp.lib

См. также раздел

Обработка защищенного содержимого в приложении

IWMDRMDeviceApp::QueryDeviceStatus

Интерфейс IWMDRMDeviceApp2