驱动开发（七）用户与内核通信

原创于 2025-12-17 09:45:00 发布 · 739 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#驱动开发

编程语言专栏收录该内容

229 篇文章

订阅专栏

一、用户与内核通信的主要方式

Windows驱动开发中，用户层程序（如应用、服务）与内核驱动通信主要有以下几种方式：

IRP请求（CreateFile/ReadFile/WriteFile/DeviceIoControl）
IOCTL（设备控制代码）
共享内存（Section Object/MapViewOfFile）
事件/信号量同步
回调机制（如Filter驱动、WMI、通知对象）

二、最常用的通信方式：IRP请求与IOCTL

1. 通信流程总览

驱动创建设备对象和符号链接
设备对象名如\\Device\\MyDevice，符号链接如\\DosDevices\\MyDeviceLink。
用户层打开设备
用CreateFile("\\\\.\\MyDeviceLink", ...)获得句柄。
用户层发起I/O请求
用ReadFile、WriteFile、DeviceIoControl等API。
驱动接收IRP请求
驱动分发函数（IRP_MJ_CREATE/READ/WRITE/DEVICE_CONTROL）处理请求。
驱动返回数据和状态
驱动设置Irp->IoStatus.Status/Information，调用IoCompleteRequest。

2. IOCTL（设备控制代码）详解

IOCTL是最灵活的通信方式，支持自定义命令和数据结构。

（1）定义IOCTL代码

#define IOCTL_MY_COMMAND CTL_CODE(FILE_DEVICE_UNKNOWN, 0x800, METHOD_BUFFERED, FILE_ANY_ACCESS)

FILE_DEVICE_UNKNOWN：设备类型
0x800：功能码
METHOD_BUFFERED：缓冲区传递方式（推荐用）
FILE_ANY_ACCESS：访问权限

（2）用户层调用 DeviceIoControl

HANDLE hDevice = CreateFile(L"\\\\.\\MyDeviceLink", ...);

DWORD bytesReturned;
MY_INPUT input = {...};
MY_OUTPUT output = {0};

BOOL ok = DeviceIoControl(
    hDevice,
    IOCTL_MY_COMMAND,
    &input, sizeof(input),
    &output, sizeof(output),
    &bytesReturned,
    NULL
);

（3）驱动分发函数处理 IRP_MJ_DEVICE_CONTROL

NTSTATUS MyDeviceControl(PDEVICE_OBJECT DeviceObject, PIRP Irp) {
    PIO_STACK_LOCATION stack = IoGetCurrentIrpStackLocation(Irp);
    ULONG code = stack->Parameters.DeviceIoControl.IoControlCode;

    if (code == IOCTL_MY_COMMAND) {
        // 获取输入缓冲区
        MY_INPUT* in = (MY_INPUT*)Irp->AssociatedIrp.SystemBuffer;
        // 获取输出缓冲区
        MY_OUTPUT* out = (MY_OUTPUT*)Irp->AssociatedIrp.SystemBuffer;

        // 处理业务，填充 out
        out->result = in->param + 1;

        Irp->IoStatus.Information = sizeof(MY_OUTPUT);
        Irp->IoStatus.Status = STATUS_SUCCESS;
    } else {
        Irp->IoStatus.Status = STATUS_INVALID_DEVICE_REQUEST;
        Irp->IoStatus.Information = 0;
    }
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
    return Irp->IoStatus.Status;
}

3. Read/Write 通信（流式数据）

用户层用ReadFile、WriteFile向驱动发送或读取数据。
驱动分发函数分别处理IRP_MJ_READ和IRP_MJ_WRITE。
适合简单数据流、环形缓冲区等场景。

4. 共享内存通信（高级场景）

用户层用CreateFileMapping和MapViewOfFile创建共享内存。
驱动用ZwOpenSection、MmMapViewInSystemSpace映射同一内存区域。
适合大数据量、高性能场景，但同步（锁、事件）要自己管理。

5. 事件/信号量同步

用户层和驱动都可以访问命名事件对象。
用于通知、等待等场景（如异步结果通知）。

三、通信缓冲区类型（METHOD_BUFFERED、METHOD_IN_DIRECT等）

METHOD_BUFFERED：系统自动分配内核缓冲区，最安全，推荐使用。
METHOD_IN_DIRECT / METHOD_OUT_DIRECT：适合大数据、DMA，用户缓冲区通过MDL锁定，驱动获得物理地址。
METHOD_NEITHER：驱动直接访问用户缓冲区指针，最危险，需自己验证和锁定。

四、注意事项与常见问题

缓冲区安全：优先用METHOD_BUFFERED，避免直接访问用户指针。
结构体对齐：用户层和驱动层结构体要完全一致，避免字节对齐问题（推荐用#pragma pack）。
权限管理：符号链接权限要合理设置，防止恶意程序访问。
同步机制：多线程/多进程访问时要用锁保护共享资源。
大数据量传输：推荐用共享内存或DIRECT方法，注意同步和分页。

五、代码完整流程示例

驱动端：

#define IOCTL_MY_COMMAND CTL_CODE(FILE_DEVICE_UNKNOWN, 0x800, METHOD_BUFFERED, FILE_ANY_ACCESS)

NTSTATUS MyDeviceControl(PDEVICE_OBJECT DeviceObject, PIRP Irp) {
    PIO_STACK_LOCATION stack = IoGetCurrentIrpStackLocation(Irp);
    ULONG code = stack->Parameters.DeviceIoControl.IoControlCode;

    if (code == IOCTL_MY_COMMAND) {
        MY_INPUT* in = (MY_INPUT*)Irp->AssociatedIrp.SystemBuffer;
        MY_OUTPUT* out = (MY_OUTPUT*)Irp->AssociatedIrp.SystemBuffer;
        out->result = in->param + 1;
        Irp->IoStatus.Information = sizeof(MY_OUTPUT);
        Irp->IoStatus.Status = STATUS_SUCCESS;
    } else {
        Irp->IoStatus.Status = STATUS_INVALID_DEVICE_REQUEST;
        Irp->IoStatus.Information = 0;
    }
    IoCompleteRequest(Irp, IO_NO_INCREMENT);
    return Irp->IoStatus.Status;
}

用户端：

HANDLE hDevice = CreateFile(L"\\\\.\\MyDeviceLink", ...);

MY_INPUT input = {123};
MY_OUTPUT output = {0};
DWORD bytesReturned = 0;

BOOL ok = DeviceIoControl(
    hDevice,
    IOCTL_MY_COMMAND,
    &input, sizeof(input),
    &output, sizeof(output),
    &bytesReturned,
    NULL
);
// output.result == 124

六、扩展：异步通信与通知机制

可以用OVERLAPPED结构实现异步IO。
驱动可以用事件、完成端口、回调等方式通知用户层。

七、IOCTL高级用法与多命令设计

1. 多命令设计

通常驱动会定义多个IOCTL命令，分别处理不同的功能：

#define IOCTL_READ_CONFIG   CTL_CODE(FILE_DEVICE_UNKNOWN, 0x801, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_WRITE_CONFIG  CTL_CODE(FILE_DEVICE_UNKNOWN, 0x802, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_DO_ACTION     CTL_CODE(FILE_DEVICE_UNKNOWN, 0x803, METHOD_BUFFERED, FILE_ANY_ACCESS)

驱动分发函数中用switch/case分支处理：

switch (code) {
    case IOCTL_READ_CONFIG:
        // 读配置
        break;
    case IOCTL_WRITE_CONFIG:
        // 写配置
        break;
    case IOCTL_DO_ACTION:
        // 执行动作
        break;
    default:
        // 未知命令
}

2. 命令与结构体设计建议

命令号建议分组，便于维护和扩展。
结构体字段应加版本号/长度，便于兼容升级。
推荐用#pragma pack(1)确保结构体无填充。

八、共享内存通信详细流程

1. 用户层创建共享内存

HANDLE hMap = CreateFileMapping(INVALID_HANDLE_VALUE, NULL, PAGE_READWRITE, 0, size, L"MySharedMem");
LPVOID pView = MapViewOfFile(hMap, FILE_MAP_WRITE, 0, 0, size);

2. 驱动层映射同一内存

驱动用ZwOpenSection和MmMapViewInSystemSpace：

UNICODE_STRING sectionName;
RtlInitUnicodeString(&sectionName, L"\\BaseNamedObjects\\MySharedMem");
HANDLE hSection;
OBJECT_ATTRIBUTES attr;
InitializeObjectAttributes(&attr, &sectionName, OBJ_CASE_INSENSITIVE, NULL, NULL);

NTSTATUS status = ZwOpenSection(&hSection, SECTION_MAP_READ | SECTION_MAP_WRITE, &attr);
if (NT_SUCCESS(status)) {
    PVOID pKernelMem = NULL;
    status = MmMapViewInSystemSpace(hSection, &pKernelMem, &size);
    // pKernelMem 就是与用户层共享的内存
}

3. 同步问题

共享内存本身不提供同步，需用锁或事件（如命名事件）保证数据一致性。
推荐用自旋锁（驱动侧）和互斥体（用户侧）协调读写。

九、异步与同步通信机制

1. 异步IO（OVERLAPPED）

用户层可以用OVERLAPPED结构实现异步IO：

OVERLAPPED ov = {0};
DeviceIoControl(hDevice, IOCTL_XXX, ..., &ov);
WaitForSingleObject(ov.hEvent, INFINITE);

驱动侧只需正常完成IRP，系统自动处理异步。

2. 驱动主动通知用户层

可用命名事件对象，驱动用KeSetEvent，用户层用WaitForSingleObject等待。
也可用回调、完成端口等高级机制。

十、用户层与驱动层结构体兼容性处理

1. 对齐问题

推荐用#pragma pack(1)或__declspec(align(1))保证结构体无填充。
结构体字段类型一致，避免32/64位差异。

2. 版本号与长度

结构体首字段加Version和Length，便于兼容升级。

typedef struct _MY_CONFIG {
    UINT32 Version;
    UINT32 Length;
    // 其他字段
} MY_CONFIG;

十一、通信安全与权限控制

1. 设备符号链接权限

创建符号链接时可指定安全描述符，限制只有管理员/特定用户可访问。

2. IOCTL命令权限

驱动可检查调用进程权限（如PsGetCurrentProcess()、SeTokenIsAdmin()），拒绝非法请求。

3. 缓冲区校验

驱动要校验缓冲区长度、指针有效性，防止越界和非法访问。

十三、性能优化建议

优先用METHOD_BUFFERED，安全且高效。
大数据量用DIRECT或共享内存，减少内核缓冲区拷贝。
尽量减少同步点和锁粒度，提升并发性能。
异步IO可提升响应速度，减少阻塞。

十四、典型问题与调试技巧

1. 结构体不兼容

用户层和驱动层结构体字段、对齐不同，导致数据错乱。
WinDbg可用dt命令查看结构体布局。

2. 权限不足

普通用户无法访问驱动设备，需提升权限或修改设备安全属性。

3. 缓冲区溢出

驱动未校验输入长度，可能导致内核崩溃或安全漏洞。

4. 死锁和同步问题

用户层和驱动层同步机制不一致，导致死锁或数据丢失。

5. 性能瓶颈

频繁小数据IO，建议合并为批量操作或用共享内存。

十五、总结

IOCTL是用户与驱动通信的首选，结构体和命令号设计要兼容且安全。
共享内存适合大数据量和高性能场景，但同步需自己实现。
异步通信和事件机制可提升响应和扩展性。
权限和安全控制是生产环境不可忽视的重点。
结构体兼容性、缓冲区安全和同步机制是驱动通信的三大关键点。