D3DKMT_ESCAPE 結構 (d3dkmthk.h)

發行項
10/07/2023

D3DKMT_ESCAPE 結構描述與顯示迷你埠驅動程式交換的資訊。

語法

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的值，指出要與顯示迷你埠驅動程序交換資訊，或控制核心模式元件。下表顯示可能的值。

ReplTest1	意義
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	pPrivateDriverData 成員是以顯示迷你埠驅動程序為目標。硬體廠商會定義逸出數據的格式。
D3DKMT_ESCAPE_VIDMM (1)	請勿使用。僅供測試用途使用。 OpenGL ICD 會控制屬於 Dxgkrnl.sys) 一部分的視訊記憶體管理員 (。 pPrivateDriverData 指向的緩衝區包含支持視訊記憶體管理員各種控制類型的 D3DKMT_VIDMM_ESCAPE 結構。
D3DKMT_ESCAPE_TDRDBGCTRL (2)	請勿使用。僅供測試用途使用。逸出作業可讓使用者控制作業系統逾時偵測和復原 (TDR) 程序的行為。此功能預設為停用。若要啟用這項功能，TdrTestMode = TdrTestMode DWORD 登錄值儲存在 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers 機碼中，必須設定為 1。 PrivateDriverDataSize 成員設定為 sizeof (int) 。 pPrivateDriverData 成員會設定為整數，其中包含來自D3DKMT_TDRDBGCTRLTYPE 列舉類型的值。
D3DKMT_ESCAPE_VIDSCH (3)	請勿使用。僅供測試用途使用。 OpenGL ICD 會控制 GPU) 排程器 (圖形處理單位 (，這是 Dxgkrnl.sys) 的一部分。 pPrivateDriverData 指向的緩衝區包含 D3DKMT_VIDSCH_ESCAPE 結構，可支援先佔控制並暫停或繼續排程器。
D3DKMT_ESCAPE_DEVICE (4)	請勿使用。僅供測試用途使用。 OpenGL ICD 控制顯示裝置。 pPrivateDriverData 指向的緩衝區包含支援從主要配置取得視訊呈現來源的 D3DKMT_DEVICE_ESCAPE 結構。
D3DKMT_ESCAPE_DMM (5)	請勿使用。僅供測試用途使用。 OpenGL ICD 控制顯示模式管理員。 pPrivateDriverData 指向的緩衝區包含 D3DKMT_DMM_ESCAPE 結構。
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6)	請勿使用。僅供測試用途使用。 OpenGL ICD 會擷取偵錯快照集緩衝區。 pPrivateDriverData 指向的緩衝區包含 D3DKMT_DEBUG_SNAPSHOT_ESCAPE 結構。
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	請勿使用。僅供測試用途使用。 OpenGL ICD 會設定顯示迷你埠驅動程式更新狀態。
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 結構，指出如何在位字段旗標中共享資訊。 OpenGL ICD 應該指定 HardwareAccess 位字段旗標，以指出顯示迷你埠驅動程式必須以這種方式存取圖形硬體，讓操作系統必須針對 DxgkDdiEscape 呼叫執行第二層同步處理至顯示迷你埠驅動程式。

[in/out] pPrivateDriverData

OpenGL ICD 配置的緩衝區指標，其中包含 OpenGL ICD 與顯示迷你埠驅動程式交換或用來控制核心模式元件的資訊。下表描述 pPrivateDriverData 所指向之緩衝區的內容，視 Type 的值而定。

Type 成員的值	pPrivateDriverData 緩衝區的內容
D3DKMT_ESCAPE_DRIVERPRIVATE	驅動程式專屬。除非 OpenGL ICD 與顯示器迷你埠驅動程式之間有緊密結合，否則無法使用緩衝區。
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結構。