Функция 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 .
| Значение | Значение |
|---|---|
|
Возвращаемые указатели IOPMVideoOutput будут использовать семантику OPM. |
|
Возвращаемые указатели 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 |