D3DKMT_ESCAPE結構（d3dkmthk.h）

發行項
02/08/2025

D3DKMT_ESCAPE 結構描述使用者模式顯示驅動程式（UMD）（或用戶端驅動程式）與內核模式顯示迷你埠驅動程式（KMD）之間交換的資訊。

語法

typedef struct _D3DKMT_ESCAPE {
  [in]     D3DKMT_HANDLE      hAdapter;
  [in]     D3DKMT_HANDLE      hDevice;
  [in]     D3DKMT_ESCAPETYPE  Type;
  [in]     D3DDDI_ESCAPEFLAGS Flags;
  [in/out] VOID               *pPrivateDriverData;
  [in]     UINT               PrivateDriverDataSize;
  [in]     D3DKMT_HANDLE      hContext;
} D3DKMT_ESCAPE;

成員

[in] hAdapter

交換資訊之圖形配接器的句柄。

[in] hDevice

如果要交換的資訊是特定裝置特有的，則為選擇性指定之顯示裝置的句柄。

[in] Type

D3DKMT_ESCAPETYPE 列舉值，指出要與 KMD 交換資訊，或控制內核模式元件。下表顯示可能的值。

值	意義
D3DKMT_ESCAPE_DRIVERPRIVATE （0）	pPrivateDriverData 成員是以 KMD 為目標。硬體廠商會定義逸出數據的格式。
D3DKMT_ESCAPE_VIDMM （1）	請勿使用;僅供測試之用。 UMD/用戶端驅動程式會控制視訊記憶體管理員（VidMm）。 pPrivateDriverData 指向的緩衝區包含支持各種 VidMm控件類型的 D3DKMT_VIDMM_ESCAPE 結構。
D3DKMT_ESCAPE_TDRDBGCTRL （2）	請勿使用;僅供測試之用。逸出作業可讓使用者控制作業系統逾時偵測和復原（TDR）程序的行為。此功能預設為停用。若要啟用這項功能，必須將儲存在 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers 機碼中的 TdrTestMode = TdrTestMode DWORD 登錄值設定為 1。 PrivateDriverDataSize 成員會設定為 sizeof（int）。 pPrivateDriverData 成員會設定為具有來自 D3DKMT_TDRDBGCTRLTYPE 列舉型別值的整數。
D3DKMT_ESCAPE_VIDSCH （3）	請勿使用;僅供測試之用。 UMD/用戶端驅動程式會控制 GPU 排程器（這是 Dxgkrnl的一部分）。 pPrivateDriverData 的緩衝區指向，其中包含支援先佔控制並暫停或繼續排程器的 D3DKMT_VIDSCH_ESCAPE 結構。
D3DKMT_ESCAPE_DEVICE （4）	請勿使用;僅供測試之用。 UMD/用戶端驅動程式會控制顯示裝置。 pPrivateDriverData 指向的緩衝區，包含支援從主要配置取得影片呈現來源的 D3DKMT_DEVICE_ESCAPE 結構。
D3DKMT_ESCAPE_DMM （5）	請勿使用;僅供測試之用。 UMD/用戶端驅動程式會控制顯示模式管理員。 pPrivateDriverData 指向包含 D3DKMT_DMM_ESCAPE 結構的緩衝區。
D3DKMT_ESCAPE_DEBUG_SNAPSHOT （6）	請勿使用;僅供測試之用。 UMD/用戶端驅動程式會擷取偵錯快照集緩衝區。 pPrivateDriverData 的緩衝區指向包含 D3DKMT_DEBUG_SNAPSHOT_ESCAPE 結構。
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS （7）	請勿使用;僅供測試之用。 UMD/用戶端驅動程式會設定 KMD 更新狀態。
D3DKMT_ESCAPE_DRT_TEST （8）	請勿使用;僅供測試之用。
D3DKMT_ESCAPE_DIAGNOSTICS （9）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT （10）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS （11）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_BDD_PNP （12）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_BDD_FALLBACK （13）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG（14）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_MODES_PRUNED_OUT（15）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_WQHL_INFO（16）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_BRIGHTNESS（17）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_EDID_CACHE（18）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO（19）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST （20）	請勿使用;僅供測試之用。從 Windows 8.1 開始支援。
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS （21）	請勿使用;僅供測試之用。從 Windows 8.1 開始支援。
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO （23）	請勿使用;僅供測試之用。從 Windows 8.1 開始支援。
D3DKMT_ESCAPE_WIN32K_START（1024）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO（1024）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK （1025）	請勿使用;僅供測試之用。從 Windows 8 開始支援。
D3DKMT_ESCAPE_WIN32K_DPI_INFO （1026）	請勿使用;僅供測試之用。從 Windows 8.1 開始支援。
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO （1027）	請勿使用;僅供測試之用。從 Windows 8.1 開始支援。
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI （1028）	請勿使用;僅供測試之用。從 Windows 8.1 開始支援。

[in] Flags

D3DDDI_ESCAPEFLAGS 結構，指出如何在位字段旗標中共享資訊。 UMD/用戶端驅動程式應指定 HardwareAccess 位欄位字段旗標，以表示 KMD 必須以這樣的方式存取圖形硬體，讓 OS 必須執行第二層同步處理到 DxgkDdiEscape 呼叫的 KMD。

使用虛擬化時，HardwareAccess 應設定為零。如需詳細資訊，請參閱 GPU 半虛擬化。

[in/out] pPrivateDriverData

UMD 或用戶端驅動程式配置的緩衝區指標，其中包含已知的驅動程式逸出結構。此結構包含驅動程式與 KMD 交換或用來控制內核模式元件的資訊。下表描述 pPrivateDriverData 指向的緩衝區內容，視 type的值而定。

型別的值	pPrivateDriverData 緩衝區的內容
D3DKMT_ESCAPE_DRIVERPRIVATE	驅動程式專屬。除非UMD/客戶端驅動程式與 KMD 之間有緊密結合，否則無法使用緩衝區。
D3DKMT_ESCAPE_VIDMM	請勿使用;僅供測試之用。 D3DKMT_VIDMM_ESCAPE 結構。
D3DKMT_ESCAPE_TDRDBGCTRL	請勿使用;僅供測試之用。 D3DKMT_TDRDBGCTRLTYPE 列舉型別。
D3DKMT_ESCAPE_VIDSCH	請勿使用;僅供測試之用。 D3DKMT_VIDSCH_ESCAPE 結構。
D3DKMT_ESCAPE_DEVICE	請勿使用;僅供測試之用。 D3DKMT_DEVICE_ESCAPE 結構。
D3DKMT_ESCAPE_DMM	請勿使用;僅供測試之用。 D3DKMT_DMM_ESCAPE 結構。
D3DKMT_ESCAPE_DEBUG_SNAPSHOT	請勿使用;僅供測試之用。 D3DKMT_DEBUG_SNAPSHOT_ESCAPE 結構。