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 调用，必须在作为 DXGKARG_ESCAPE 成员的 D3DDDI_ESCAPEFLAGS 结构中设置 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 可分页。