Функция OPMGetVideoOutputsFromIDirect3Device9Object (opmapi.h)

  • Статья

Создает объект Output Protection Manager (OPM) для каждого физического монитора, связанного с определенным устройством Direct3D.

Синтаксис

HRESULT OPMGetVideoOutputsFromIDirect3DDevice9Object(
  [in]  IDirect3DDevice9           *pDirect3DDevice9,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

Параметры

[in] pDirect3DDevice9

Указатель на интерфейс IDirect3DDevice9 устройства Direct3D.

[in] vos

Член перечисления OPM_VIDEO_OUTPUT_SEMANTICS .

Значение Значение
OPM_VOS_OPM_SEMANTICS
 Возвращаемые указатели IOPMVideoOutput будут использовать семантику OPM.
OPM_VOS_COPP_SEMANTICS
 Возвращаемые указатели IOPMVideoOutput будут использовать семантику протокола COPP.

[out] pulNumVideoOutputs

Получает количество указателей IOPMVideoOutput , возвращаемых в параметре pppOPMVideoOutputArray .

[out] pppOPMVideoOutputArray

Получает указатель на массив указателей IOPMVideoOutput . Каждый указатель IOPMVideoOutput связан с одним физическим монитором. Вызывающий объект должен освободить каждый указатель в массиве и вызвать CoTaskMemFree , чтобы освободить массив.

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

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Одно устройство Direct3D можно связать с несколькими физическими мониторами. Каждый физический монитор имеет собственный соединитель. Приложение должно настроить механизм защиты отдельно для каждого физического монитора с помощью указателей IOPMVideoOutput , возвращаемых в pppOPMVideoOutputArray.

Интерфейс IOPMVideoOutput имеет два режима поведения в зависимости от значения параметра vos . Если vos OPM_VOS_COPP_SEMANTICS, IOPMVideoOutput использует семантику COPP. Этот режим предназначен для обеспечения обратной совместимости с COPP. Если vos OPM_VOS_OPM_SEMANTICS, IOPMVideoOutput использует более новую семантику OPM. Различия в поведении отмечаются на справочной странице для каждого метода. Режим не меняется в течение времени существования объекта.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header opmapi.h
Библиотека Dxva2.lib
DLL Dxva2.dll

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

Функции OPM