DXGKDDI_ESCAPE回呼函式（d3dkmddi.h）

DxgkDdiEscape 函式會與使用者模式顯示驅動程式共享資訊。

語法

DXGKDDI_ESCAPE DxgkddiEscape;

NTSTATUS DxgkddiEscape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_ESCAPE pEscape
)
{...}

[in] hAdapter

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

[in] pEscape

包含共用資訊相關信息之 DXGKARG_ESCAPE 結構的指標。

Note 若要在第二層下呼叫 DxgkDdiEscape，必須在屬於 DXGKARG_ESCAPE的 D3DDDI_ESCAPEFLAGS 結構內設定 HardwareAccess 旗標。如果未設定此旗標，則呼叫將會失敗。

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

傳回碼	描述
STATUS_SUCCESS	DxgkDdiEscape 已成功共享資訊。
STATUS_INVALID_PARAMETER	傳遞至 DxgkDdiEscape 的參數包含導致其無法完成的錯誤。
STATUS_NO_MEMORY	DxgkDdiEscape 無法配置完成所需的記憶體。
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape 偵測到非特殊許可權的指令（也就是，存取記憶體超出目前中央處理單位 [CPU] 進程許可權的指令）。
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape 偵測到圖形硬體不支援的指示。
STATUS_GRAPHICS_DRIVER_MISMATCH	顯示迷你埠驅動程式與起始對 DxgkDdiEscape 呼叫的使用者模式顯示驅動程式不相容。

每當使用者模式顯示驅動程式必須透過其他驅動程式通訊不支援的方式，DirectX 圖形核心子系統會呼叫 display miniport 驅動程式的 DxgkDdiEscape 函式。

DxgkDdiEscape 應設為可分頁。