OPMGetVideoOutputsFromIDirect3DDevice9Object 函数 (opmapi.h)

  • 项目

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

语法

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

参数

[in] pDirect3DDevice9

指向 Direct3D 设备的 IDirect3DDevice9 接口的指针。

[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 错误代码。

注解

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

IOPMVideoOutput 接口有两种行为模式，具体取决于 vos 参数的值。 如果 vos 是OPM_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 函数