DXGKDDI_OPM_CREATE_PROTECTED_OUTPUT回呼函式 (dispmprt.h)
DxgkDdiOPMCreateProtectedOutput 函式會使用認證輸出保護通訊協定建立新的受保護輸出物件, (COPP) 或 OPM 語意。
語法
DXGKDDI_OPM_CREATE_PROTECTED_OUTPUT DxgkddiOpmCreateProtectedOutput;
NTSTATUS DxgkddiOpmCreateProtectedOutput(
[in] PVOID MiniportDeviceContext,
[in] D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[in] DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS NewVideoOutputSemantics,
[out] PHANDLE NewProtectedOutputHandle
)
{...}
參數
[in] MiniportDeviceContext
與顯示配接器相關聯的內容區塊句柄。 先前,顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式提供此句柄給 DirectX 圖形核心子系統。
[in] VidPnTargetId
整數,可唯一識別對應至新受保護輸出物件的影片呈現目標。 每個影片簡報目標都必須對應至一個實體監視器連接器。 如果 VidPnTargetId 對應至多個實體監視器連接器, DxgkDdiOPMCreateProtectedOutput 應該會傳回STATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLED或STATUS_GRAPHICS_OPM_THEATER_MODE_ENABLED錯誤碼。
[in] NewVideoOutputSemantics
DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS型別值,決定新的受保護輸出是否有 COPP 或 OPM 語意。
[out] NewProtectedOutputHandle
如果 DxgkDdiOPMCreateProtectedOutput 成功傳回,則會接收新受保護輸出物件的句柄的變數指標。 DirectX 圖形核心子系統會在呼叫顯示迷你埠驅動程式的 DxgkDdiOPMGetRandomNumber 中傳遞此句柄, DxgkDdiOPMSetSigningKeyAndSequenceNumbersDxgkDdiOPMGetInformation、 DxgkDdiOPMGetCOPPCompatibleInformation、 DxgkDdiOPMConfigureProtectedOutput 和 DxgkDdiOPMDestroyProtectedOutput。
如果 DxgkDdiOPMCreateProtectedOutput 失敗,變數的值會保持不變。
傳回值
DxgkDdiOPMCreateProtectedOutput 會傳回下列其中一個值。
傳回碼 | Description |
---|---|
STATUS_SUCCESS | 函式已成功建立新的受保護輸出物件。 |
STATUS_GRAPHICS_OPM_NOT_SUPPORTED | 顯示迷你埠驅動程式不支援 OPM,因為硬體廠商從未簽署 OPM 許可協定,或迷你埠驅動程式的圖形硬體不符合 OPM 規則。 |
STATUS_GRAPHICS_COPP_NOT_SUPPORTED | 顯示迷你埠驅動程式不支援 COPP,因為硬體廠商從未簽署 COPP 許可協定,或迷你埠驅動程式的圖形硬體不符合 COPP 規則。 |
STATUS_NO_MEMORY | DxgkDdiOPMCreateProtectedOutput 無法配置完成所需的記憶體。 |
STATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLED | DxgkDdiOPMCreateProtectedOutput 無法建立受保護的輸出,因為影片呈現目標處於跨越模式。 當影片呈現目標處於跨越模式時,它會對應到多個實體監視器連接器,而每個連接器都會顯示畫面緩衝區的個別部分。 如需顯示迷你埠驅動程式通常如何實作跨越模式的圖表,請參閱一節。 顯示迷你埠驅動程式會通知操作系統畫面緩衝區對應至特定監視器的方式。 畫面緩衝區的左半部會顯示在一部監視器上,而畫面緩衝區的右半部則會顯示在另一個監視器上。 |
STATUS_GRAPHICS_OPM_THEATER_MODE_ENABLED | DxgkDdiOPMCreateProtectedOutput 無法建立受保護的輸出,因為影片呈現目標處於電影模式。 當影片呈現目標處於電影模式時,它會對應至兩個實體監視器連接器;一個連接器會顯示整個框架緩衝區,另一個連接器只會顯示框架緩衝區的一部分。 電影模式也稱為鏡像模式。 如需顯示迷你埠驅動程式通常如何實作藝術模式的圖表,請參閱一節。 顯示迷你埠驅動程式會通知操作系統畫面緩衝區對應至特定監視器的方式。 整個畫面緩衝區會顯示在一個監視器上,而畫面緩衝區的一部分只會顯示在另一個監視器上。 |
此函式也可能傳回 Ntstatus.h 中定義的其他錯誤碼。
備註
下圖顯示迷你埠驅動程式通常會如何實作跨越模式。
下圖顯示顯示迷你埠驅動程式通常如何實作運動模式。 *DxgkDdiOPMCreateProtectedOutput* 的圖表應該可分頁。規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dispmprt.h (包含 Dispmprt.h) |
IRQL | PASSIVE_LEVEL (请参阅一节) |
另請參閱
DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS
DxgkDdiOPMConfigureProtectedOutput
DxgkDdiOPMDestroyProtectedOutput