OPMGetVideoOutputsFromHMONITOR 函数 (opmapi.h)

  • 项目

为每个与特定 HMONITOR 句柄关联的物理监视器创建输出保护管理器 (OPM) 对象。

语法

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

parameters

[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

接收 pppOPMVideoOutputArray 参数中返回的 IOPMVideoOutput 指针 数。

[out] pppOPMVideoOutputArray

接收指向 IOPMVideoOutput 指针数组的指针。 每个 IOPMVideoOutput 指针都与单个物理监视器相关联。 调用方必须释放数组中的每个指针，并调用 CoTaskMemFree 来释放数组。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

单个 HMONITOR 句柄可以与多个物理监视器相关联。 每个物理监视器都有自己的连接器。 应用程序必须使用 pppOPMVideoOutputArray 中返回的 IOPMVideoOutput 指针为每个物理监视器单独设置保护机制。

IOPMVideoOutput 接口有两种行为模式，具体取决于 vos 参数的值。 如果 vosOPM_VOS_COPP_SEMANTICS， IOPMVideoOutput 将使用 COPP 语义。 此模式旨在与 COPP 向后兼容。 如果 vosOPM_VOS_OPM_SEMANTICS， IOPMVideoOutput 将使用更新的 OPM 语义。 每个方法的参考页上都记录了行为差异。 模式在对象的生存期内不会更改。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 opmapi.h
Library Dxva2.lib
DLL Dxva2.dll

请参阅

OPM 函数