Метод IWMDRMDeviceApp::AcquireDeviceData

Статья
06/12/2023

Метод AcquireDeviceData инициализирует или сбрасывает защищенные часы устройства.

Синтаксис

HRESULT AcquireDeviceData(
  [in]  IWMDMDevice    *pDevice,
  [in]  IWMDMProgress3 *pProgressCallback,
  [in]  DWORD          dwFlags,
  [out] DWORD          *pdwStatus
);

Параметры

pDevice [in]

Указатель на интерфейс IWMDMDevice для устройства, которое будет передавать данные измерения.

pProgressCallback [in]

Обратный вызов хода выполнения, с помощью которого приложение может отслеживать ход выполнения события или отменять событие. Ход выполнения определяется параметром EventId методов IWMDMProgress3 .

dwFlags [in]

Логическое ИЛИ одного или обоих следующих флагов, указывающее, какое действие необходимо выполнить. Это значение извлекается из параметра pdwStatusобъекта IWMDRMDeviceApp::QueryDeviceStatus или IWMDRMDeviceApp2::QueryDeviceStatus2. Флаг pdwStatus можно использовать напрямую.

Flag	Описание
WMDRM_DEVICE_NEEDCLOCK	Получение часов на защищенном сервере часов.
WMDRM_DEVICE_REFRESHCLOCK	Обновите часы с защищенного сервера часов.

pdwStatus [out]

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

Состояние	Описание
0	Действие не поддерживается.
1	Не удалось получить защищенные часы устройства из службы.
2	Не удалось установить безопасные часы устройства.
3	Были установлены безопасные часы устройства.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
DRM_E_INVALIDARG	Один или несколько аргументов являются недопустимыми.
NS_E_DEVICE_NOT_WMDRM_DEVICE	Указанное устройство не является устройством, совместимым с DRM Windows Media.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK	Не удалось получить запрос на безопасные часы с устройства или не удалось получить URL-адрес защищенных часов из запроса.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK_FROM_SERVER	Не удалось получить ответ на защищенные часы с защищенного сервера часов.
NS_E_DRM_UNABLE_TO_SET_SECURE_CLOCK	Не удалось отправить запрос на безопасные часы на устройство или устройство не удалось установить часы.

Это асинхронный метод; устройство должно ожидать обратного вызова IWMDMProgress::End для этой операции, прежде чем пытаться воспроизвести любое лицензированное содержимое.

Приложение может узнать, должно ли устройство сбросить часы или обновить его, вызвав IWMDRMDeviceApp::QueryDeviceStatus или IWMDRMDeviceApp2::QueryDeviceStatus2.

Приложение должно иметь подключение к Интернету, чтобы оно могло получить или сбросить безопасные часы.

Требования

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

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

Обработка защищенного содержимого в приложении
Интерфейс IWMDMDevice
Интерфейс IWMDMProgress3
Интерфейс IWMDRMDeviceApp

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