DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT回呼函式 (dispmprt.h)

發行項
02/23/2024

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 傳回下列其中一個值：

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

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

備註

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

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 應該可分頁。