如何在WDDM 2.0中通过ExtEscape读写硬件及实现内核驱动调用？

首先明确：使用ExtEscape API配合核心态显示驱动来读写硬件信息是完全可行的，不需要创建新设备或添加私有函数——ExtEscape本身就是GDI提供的、用于用户态程序与显示驱动传递私有命令的标准机制，复用现有显示设备的HDC即可完成交互。

核心态驱动需要执行的操作及实现步骤 #

1. 实现驱动的DrvEscape回调函数 #

核心态显示驱动的DrvEscape是处理ExtEscape请求的入口，GDI会将用户态ExtEscape调用直接转发到这个函数。函数原型如下：

ULONG DrvEscape(
    SURFOBJ *pso,
    ULONG iEsc,
    ULONG cjIn,
    PVOID pvIn,
    ULONG cjOut,
    PVOID pvOut
);

参数说明：

• pso：关联目标显示设备的表面对象；
• iEsc：用户态传入的自定义Escape码（建议用0x8000及以上未占用范围，避免与系统预定义码冲突）；
• cjIn/pvIn：输入数据的长度与用户态缓冲区地址；
• cjOut/pvOut：输出数据的长度与用户态缓冲区地址。

2. 注册私有Escape码（可选但推荐） #

驱动初始化阶段，可通过EngCreateDriverEscape注册你的私有Escape码，确保GDI能正确识别并转发请求到DrvEscape函数，示例框架：

NTSTATUS DriverEntry(PDRIVER_OBJECT DriverObject, PUNICODE_STRING RegistryPath)
{
    // 其他初始化逻辑
    EngCreateDriverEscape(0x8000, DrvEscape); // 注册自定义Escape码0x8000
    // ...
}

3. 核心态内的安全处理与硬件操作 #

在DrvEscape函数中必须完成以下关键逻辑：

• 内存安全校验：对用户态传入的pvIn和pvOut缓冲区，用ProbeForRead和ProbeForWrite验证内存合法性，防止非法访问导致系统崩溃；
• 权限检查：通过SeAccessCheck等机制校验调用进程权限，确保仅授权程序可操作硬件；
• 硬件访问实现：根据输入参数的指令（如读/写寄存器）完成硬件操作：
  • 访问MMIO空间时，先用MmMapIoSpace将物理地址映射到核心态虚拟地址；
  • 使用READ_REGISTER_ULONG/WRITE_REGISTER_ULONG等DDI宏操作硬件寄存器；
  • 临时映射完成后用MmUnmapIoSpace解除映射。

4. 返回处理结果 #

成功时返回实际写入输出缓冲区的字节数，失败时返回0或自定义错误码，用户态可通过ExtEscape的返回值判断操作结果。

用户态ExtEscape调用示例 #

用户态只需获取目标显示设备的HDC，再调用ExtEscape传入自定义参数：

// 获取桌面HDC（或指定显示设备的HDC）
HDC hdc = GetDC(NULL);
if (!hdc) { /* 错误处理 */ }

// 自定义数据结构：操作类型+寄存器地址+写入值（写操作时用）
typedef struct {
    UINT8 opType;   // 0=读，1=写
    UINT32 regAddr;
    UINT32 regValue;
} EscapeData;

EscapeData inData = {0, 0x1000, 0}; // 读0x1000地址的寄存器
UINT32 outValue = 0;

// 调用ExtEscape，传入自定义Escape码0x8000
int result = ExtEscape(hdc, 0x8000, sizeof(inData), (LPCSTR)&inData, sizeof(outValue), (LPSTR)&outValue);
if (result > 0) {
    // 读取成功，outValue为硬件返回值
} else {
    // 操作失败
}

ReleaseDC(NULL, hdc);

注意事项 #

• 自定义Escape码需避开系统预定义值（如QUERYESCSUPPORT=8、GETTECHNOLOGY=2等），优先使用0x8000及以上范围；
• 用户态与核心态的输入输出数据结构必须严格一致，避免解析错误；
• 核心态操作硬件需严格遵循Windows DDI规范，禁止直接操作未映射的物理地址。

内容的提问来源于stack exchange，提问作者dengchow