DXGKDDI_ESCAPE回调函数（d3dkmddi.h）

DxgkDdiEscape 函数与用户模式显示驱动程序共享信息。

语法

DXGKDDI_ESCAPE DxgkddiEscape;

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

[in] hAdapter

与显示适配器关联的上下文块的句柄。显示微型端口驱动程序以前向 MiniportDeviceContext 中的 Microsoft DirectX 图形内核子系统提供了此句柄，DxgkDdiAddDevice 函数的输出参数。

[in] pEscape

指向包含共享信息信息的 DXGKARG_ESCAPE 结构的指针。

注意为了使 DxgkDdiEscape 调用在二级下进行，必须在 D3DDDI_ESCAPEFLAGS 结构（DXGKARG_ESCAPE成员）中设置 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 图形内核子系统将调用显示微型端口驱动程序的 DxgkDdiEscape 函数。

应 DxgkDdiEscape 进行分页。