OPMGetVideoOutputsFromIDirect3DDevice9Object 函式 (opmapi.h)

針對與特定 Direct3D 裝置相關聯的每個實體監視器,建立 Output Protection Manager (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 參數的值而定。 如果 vosOPM_VOS_COPP_SEMANTICS,IOPMVideoOutput 會使用 COPP 語意。 此模式適用於與COPP的回溯相容性。 如果 vosOPM_VOS_OPM_SEMANTICS,IOPMVideoOutput 會使用較新的 OPM 語意。 每個方法的參考頁面上會說明行為差異。 模式不會在物件的存留期期間變更。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 opmapi.h
程式庫 Dxva2.lib
Dll Dxva2.dll

另請參閱

OPM 函式