D3DKMT_ESCAPE结构 (d3dkmthk.h)

项目
05/23/2024

D3DKMT_ESCAPE结构描述与显示微型端口驱动程序交换的信息。

语法

typedef struct _D3DKMT_ESCAPE {
  [in]     D3DKMT_HANDLE      hAdapter;
  [in]     D3DKMT_HANDLE      hDevice;
  [in]     D3DKMT_ESCAPETYPE  Type;
  [in]     D3DDDI_ESCAPEFLAGS Flags;
  void               D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  [in]     UINT               PrivateDriverDataSize;
  [in]     D3DKMT_HANDLE      hContext;
} D3DKMT_ESCAPE;

成员

[in] hAdapter

用于交换信息的图形适配器的句柄。

[in] hDevice

显示设备的句柄，如果要交换的信息特定于特定设备，则可选择指定该句柄。

[in] Type

类型的值D3DKMT_ESCAPETYPE，指示与显示微型端口驱动程序交换信息或控制内核模式组件。下表列出了可能的值。

值	含义
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	pPrivateDriverData 成员以显示微型端口驱动程序为目标。硬件供应商定义转义数据的格式。
D3DKMT_ESCAPE_VIDMM (1)	请勿使用。仅用于测试目的。 OpenGL ICD 控制视频内存管理器 (这是 Dxgkrnl.sys) 的一部分。 pPrivateDriverData 指向的缓冲区包含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)	请勿使用。仅用于测试目的。 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 调用。

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

[in] PrivateDriverDataSize

pPrivateDriverData 指向的缓冲区的大小（以字节为单位）。 OpenGL ICD 在调用 D3DKMTEscape 函数时必须指定缓冲区的大小。

[in] hContext

如果要交换的信息特定于特定设备上下文，则为可选指定的上下文句柄。如果 OpenGL ICD 将 hContext 设置为非 NULL 值，则 ICD 还必须将 hDevice 设置为非 NULL 值，并且 hDevice 必须与拥有上下文的设备相对应。