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

  • Статья

Создает объект диспетчера защиты вывода (OPM) для каждого физического монитора, связанного с определенным дескриптором HMONITOR .

Синтаксис

HRESULT OPMGetVideoOutputsFromHMONITOR(
  [in]  HMONITOR                   hMonitor,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

Параметры

[in] hMonitor

Дескриптор монитора, для которого создаются объекты OPM. Существует несколько функций, возвращающих значения HMONITOR . Дополнительные сведения см. в разделе Функции нескольких мониторов в документации по интерфейсу графических устройств Windows (GDI).

[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 .

Комментарии

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

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

Требования

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

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

Функции OPM