Метод IWMDRMDeviceApp2::QueryDeviceStatus2

Статья
06/12/2023

Метод 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

Share via