DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT回呼函式（dispmprt.h）

發行項
02/06/2025

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 函式會設定指定的受保護輸出物件。

語法

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkddiOpmConfigureProtectedOutput;

NTSTATUS DxgkddiOpmConfigureProtectedOutput(
  [in] PVOID MiniportDeviceContext,
  [in] HANDLE ProtectedOutputHandle,
  [in] const DXGKMDT_OPM_CONFIGURE_PARAMETERS *Parameters,
  [in] ULONG AdditionalParametersSize,
  [in] const VOID *AdditionalParameters
)
{...}

參數

[in] MiniportDeviceContext

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 DirectX 圖形核心子系統。

[in] ProtectedOutputHandle

受保護輸出物件的句柄。 DxgkDdiOPMCreateProtectedOutput 函式會建立受保護的輸出物件，並將句柄傳回給物件。

[in] Parameters

DXGKMDT_OPM_CONFIGURE_PARAMETERS 結構的指標，其中包含用來設定受保護輸出對象的參數，其句柄是在 ProtectedOutputHandle 參數中指定。

[in] AdditionalParametersSize

緩衝區中其他參數的大小，以位元組為單位，AdditionalParameters 所指向，。針對認證的輸出保護通訊協定（COPP）模擬，這是 0。

[in] AdditionalParameters

緩衝區的指標，這個緩衝區會保存用來設定受保護輸出物件的其他參數，其句柄是在 protectedOutputHandle 參數中指定的。針對 COPP 模擬，這是 NULL。如果 AdditionalParametersSize 參數設定為 0，AdditionalParameters 一律設定為 NULL。

傳回值

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 會傳回下列其中一個值：

傳回碼	描述
STATUS_SUCCESS	函式已成功設定受保護的輸出物件。
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput 無法配置完成所需的記憶體。

此函式也可能傳回 Ntstatus.h中定義的其他錯誤碼。

言論

DirectX 圖形核心子系統會呼叫 DxgkDdiOPMGetInformation 或 DxgkDdiOPMGetCOPPCompatibleInformation，以擷取輸出的相關信息，然後呼叫 DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 一或多次來設定輸出。

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 應該設為可分頁。