DXGKDDI_ESCAPE回呼函式 (d3dkmddi.h)

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

語法

DXGKDDI_ESCAPE DxgkddiEscape;

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

[in] hAdapter

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

[in] pEscape

包含共用資訊之 DXGKARG_ESCAPE 結構的指標。

注意為了讓 DxgkDdiEscape 呼叫在第二層下進行，HardwareAccess 旗標必須在屬於DXGKARG_ESCAPE成員的 D3DDDI_ESCAPEFLAGS 結構中設定。如果未設定此旗標，則呼叫將會失敗。

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

傳回碼	Description
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 圖形核心子系統就會呼叫顯示迷你埠驅動程式的 DxgkDdiEscape 函式。

DxgkDdiEscape 應該可分頁。