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

Метод IWMDRMDeviceApp::AcquireDeviceData

  • Статья

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