1. 内核驱动不是 DLL:WDK 与 VC++ 拼出来的到底是什么
很多人第一次接触 Windows 内核驱动开发,直觉是拿 VC++ 新建一个 DLL 工程,导出两个函数就算完事。真把产物丢到目标机才发现系统压根不认这个 .dll——内核态加载的是 .sys 映像,入口叫 DriverEntry 而不是 DllMain。WDK 这套工具链的价值就在这里:它把 VC++ 的编译器、内核头文件、链接脚本和 INF 安装描述捆在一起,产出的是操作系统愿意加载并按约定调用的内核扩展。它面向 USB 自定义设备通信、PCIe 加速卡控制、采集卡帧同步、打印机固件交互、进程/文件/注册表实时监控这类需求。想快速出 GUI 工具的人不适合这条路,改一行代码重启验证是常态。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 把 WDK 接进 VC++:工程骨架、编译产物与 INF 三段式
2.1 工程类型与源文件分层
WDK 装好之后,VC++ 的新建工程里会多出驱动模板。选型上有两条路:KMDF 工程和空 WDM 工程。KMDF 框架帮你处理了大部分 PnP 和电源管理样板,起步快;空 WDM 工程则把所有回调都摊在你面前,适合要把设备对象、IRP 分发、卸载流程完全握在手里的场景。这条路线走的是 WDM/WDK,第一次搭骨架建议直接用空 WDM 工程,因为你能看清每一个回调是谁注册的。
文件分层不要按"一个文件写到底"的路子来,编译器不会拦你,但调试时会让你抓狂。我一般按职责拆成下面这几块,改错时能直接定位到改哪个文件:
| 文件 | 职责 | 写错时的典型表现 |
|---|---|---|
driver.c / driver.h |
DriverEntry、卸载例程、全局驱动对象 |
加载返回失败码,事件日志里一条错误 |
device.c / device.h |
AddDevice、设备对象、符号链接、设备扩展 |
用户态 CreateFile 打不开,错误码 2 或 5 |
dispatch.c / dispatch.h |
各 IRP_MJ_* 分发函数 |
用户态调用挂死或直接蓝屏 |
public.h |
与用户态共享的 IOCTL 码、结构体定义 | 两边结构体不一致,读出来的数据错位 |
xxx.inf |
安装描述、服务注册、硬件 ID 匹配 | 设备管理器黄色感叹号,驱动装不上 |
public.h 这一层最容易被省掉。省掉的结果是用户态程序里自己写一份结构体,字段对齐、指针宽度、#pragma pack 一旦有一处不同,驱动收到的数据就是乱的,而编译期不会有任何提示。这个坑我在一个采集卡项目上踩过,最后靠逐字段打印十六进制才定位到。
2.2 从源码到 .sys:编译产物与依赖
编译配置有几项必须改,默认值基本都不对:
| 配置项 | 建议取值 | 原因 |
|---|---|---|
| 目标平台 | 与目标机一致,通常是 x64 | 32 位驱动进不了 64 位内核,加载直接被拒 |
| 目标系统版本 | 取目标机最低支持版本 | 版本定高了会链接到目标机上不存在的内核导出函数 |
| 运行库 | 不使用运行库(内核模式) | 内核态没有用户态 CRT,链接了会报 LNK2019 找不到符号 |
| 警告等级 | /W4 或更高 |
内核代码里整数截断、指针宽度警告往往就是真 bug |
| 缓冲区安全检查 | 打开 | 分发函数里的 RtlCopyMemory 全靠它兜底 |
"不使用运行库"这条是新手最常卡住的地方。现象很明确:编译阶段报一堆 LNK2019 unresolved external symbol,符号名带 memcpy、strcpy、__security_check_cookie 之类。原因是你无意中调用了用户态 CRT 函数。解决不是去找库,而是换成内核版本:RtlCopyMemory 代替 memcpy,RtlZeroMemory 代替 memset,字符串处理用 RtlStringCch* 系列。内核里没有异常处理帮你兜底,一次越界写就是一次蓝屏。
编译完成后目录里会出四样东西,缺一样都会在后面卡住:
.sys:驱动映像本体,这就是要被加载的文件;.pdb:符号文件,调试时必须和.sys放在一起,否则调试器只能看到一串地址;.inf:安装描述,告诉系统这个驱动服务怎么注册;.cat:签名目录,正式发布时随驱动一起走签名流程。
.pdb 一定要留。我见过有人为了"发布干净"把 .pdb 删了,结果线上出问题时拿到的崩溃栈全是 +0x1a3 这种偏移,只能靠反汇编猜位置,排查成本翻好几倍。
2.3 INF 与安装:让系统认这个驱动
INF 是把 .sys 变成"系统认识的服务"的那份说明书。它不参与编译,但写错了驱动装都装不上。最小可用的一份长这样:
ini复制; 最小 WDM 驱动安装描述,扩展名必须为 .inf
[Version]
Signature = "$WINDOWS NT$"
Class = System
ClassGuid = {按实际设备类别填对应 GUID}
Provider = %VendorName%
DriverVer = 01/01/2024,1.0.0.0
[Manufacturer]
%VendorName% = DeviceList, NTamd64
; 硬件 ID 必须与设备实际上报的完全一致,否则安装时匹配不到
[DeviceList.NTamd64]
%DeviceDesc% = InstallSection, USB\VID_0000&PID_0000
[InstallSection.NTamd64]
CopyFiles = FilesToCopy
AddReg = AddRegistry
[InstallSection.NTamd64.Services]
AddService = MyKernelDriver, 0x00000002, ServiceSection
[ServiceSection]
DisplayName = %ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %12%\MyKernelDriver.sys
[FilesToCopy]
MyKernelDriver.sys
[AddRegistry]
HKR,,DriverParams,0x00010001,0
[Strings]
VendorName = "某公司"
DeviceDesc = "某自定义设备"
ServiceDesc = "某内核驱动服务"
几个字段值得单独说清楚。ServiceType = 1 表示这是内核驱动服务,填成 2(文件系统驱动)系统会用另一套加载逻辑。StartType 决定加载时机:0 是引导启动,1 是系统启动,2 是自动,3 是按需(手动),调试阶段用 3 最省事,改完驱动重新加载即可,不必重启。ErrorControl = 1 表示普通错误,加载失败只记日志不影响启动;改成 3 之后驱动加载失败会直接让系统起不来,调试期千万别设。
ServiceBinary = %12%\... 里的 %12% 是系统目录(System32\drivers)的缩写,不要写成绝对路径。AddService 那一行末尾的 0x00000002 是标志位,含义是"如果服务已存在则覆盖",重复安装时靠它更新。
%DeviceDesc% 和 HardwareID 对不上是安装失败的头号原因。现象是设备管理器里出现一个未知设备,右键更新驱动时提示"找不到兼容的驱动程序"。原因通常是硬件 ID 的写法差了一个反斜杠或者大小写,或者 [DeviceList.NTamd64] 这一段的装饰名和 [Manufacturer] 里引用的名字对不上。这个错误不会告诉你哪一行错了,只能一行行核对。
3. DriverEntry 与 AddDevice:让驱动先能被加载起来
3.1 DriverEntry 的签名、返回值与卸载例程
DriverEntry 是系统加载驱动后调用的第一个函数,IRQL 处于 PASSIVE_LEVEL,也就是可以调大多数会阻塞的内核 API。它的返回值决定生死:返回 STATUS_SUCCESS 系统才会认为加载成功,返回任何其他值系统会立刻停止加载,并且不会调用卸载例程——因为从系统角度看这个驱动从未启动过。这一条决定了入口函数里所有失败分支都必须自己回收资源。
c复制#include <ntddk.h>
static NTSTATUS MyAddDevice(PDRIVER_OBJECT DriverObject, PDEVICE_OBJECT PhysicalDeviceObject);
static NTSTATUS MyCreateClose(PDEVICE_OBJECT DeviceObject, PIRP Irp);
static NTSTATUS MyRead(PDEVICE_OBJECT DeviceObject, PIRP Irp);
static NTSTATUS MyWrite(PDEVICE_OBJECT DeviceObject, PIRP Irp);
/* 卸载例程:只有 DriverEntry 里赋过值,系统才会在卸载时调用 */
static VOID MyDriverUnload(PDRIVER_OBJECT DriverObject)
{
UNREFERENCED_PARAMETER(DriverObject);
/* 回收 DriverEntry 里申请的资源,按创建逆序释放 */
}
/* 入口:返回非 STATUS_SUCCESS 系统不会加载,也不会回调卸载例程 */
NTSTATUS DriverEntry(PDRIVER_OBJECT DriverObject, PUNICODE_STRING RegistryPath)
{
UNREFERENCED_PARAMETER(RegistryPath);
/* 1. 先把卸载例程挂上,后面任何一步失败都能走统一回收路径 */
DriverObject->DriverUnload = MyDriverUnload;
/* 2. 注册分发函数,没注册的 IRP 由系统默认处理 */
DriverObject->MajorFunction[IRP_MJ_CREATE] = MyCreateClose;
DriverObject->MajorFunction[IRP_MJ_CLOSE] = MyCreateClose;
DriverObject->MajorFunction[IRP_MJ_READ] = MyRead;
DriverObject->MajorFunction[IRP_MJ_WRITE] = MyWrite;
/* 3. 挂 AddDevice,PnP 设备到达时由系统回调 */
DriverObject->DriverExtension->AddDevice = MyAddDevice;
return STATUS_SUCCESS;
}
顺序上把 DriverUnload 放在第一步,是有意的。如果先注册分发函数再赋值卸载例程,中间任何一次初始化失败,return 之后系统不会调用卸载,你在前面申请的资源就永久泄漏在内核池里,直到重启。先挂卸载例程,后面所有失败分支统一 goto cleanup,清理逻辑只写一遍。
MajorFunction 数组的下标是 IRP 的主功能码。没注册的项系统会用默认处理,但 IRP_MJ_CREATE 不注册的后果是用户态 CreateFile 直接返回失败,很多人卡在这一步,以为符号链接没建对,其实只是少注册了一个数组项。IRP_MJ_CLEANUP 和 IRP_MJ_CLOSE 的区别也要注意:CLEANUP 在最后一个用户态句柄关闭时来,CLOSE 在所有引用都释放后才来,两者不能混用同一个处理函数去做资源回收。
RegistryPath 指向驱动自己的 Parameters 注册表键路径,但这个缓冲区的生命周期只到 DriverEntry 返回为止。想把它留着后面用,必须在入口里复制一份出来,直接存指针后面访问就是野指针。
3.2 AddDevice 与设备对象命名
驱动加载成功后,系统并不会立刻给你一个设备对象。设备对象的创建发生在 AddDevice 回调里,只有在 PnP 管理器枚举到一个匹配的设备时才被调用。所以 DriverEntry 里只做注册,真正的对象创建放在 AddDevice。
c复制static NTSTATUS MyAddDevice(PDRIVER_OBJECT DriverObject, PDEVICE_OBJECT PhysicalDeviceObject)
{
PDEVICE_OBJECT devObj = NULL;
UNICODE_STRING devName;
UNICODE_STRING symLink;
NTSTATUS status;
UNREFERENCED_PARAMETER(PhysicalDeviceObject);
RtlInitUnicodeString(&devName, L"\\Device\\MyKernelDriver");
RtlInitUnicodeString(&symLink, L"\\DosDevices\\MyKernelDriver");
/* 第 2 个参数是设备扩展大小,自己的上下文都放这里 */
status = IoCreateDevice(DriverObject,
sizeof(MY_DEVICE_EXTENSION),
&devName,
FILE_DEVICE_UNKNOWN,
FILE_DEVICE_SECURE_OPEN,
FALSE,
&devObj);
if (!NT_SUCCESS(status)) {
return status;
}
/* 符号链接让用户态能用 CreateFile 打开这个设备 */
status = IoCreateSymbolicLink(&symLink, &devName);
if (!NT_SUCCESS(status)) {
IoDeleteDevice(devObj); /* 链接失败必须回收设备对象 */
return status;
}
return STATUS_SUCCESS;
}
IoCreateDevice 的参数逐个说。第二个参数是设备扩展字节数,填 0 表示不要扩展,那样所有设备状态都得用全局变量存——多设备场景直接打架。我建议一开始就留扩展,哪怕现在只有一个字段。第三个参数是设备名,传 NULL 表示匿名设备,只能靠 PnP 接口访问,用户态 CreateFile 打不开。第四个是设备类型,FILE_DEVICE_UNKNOWN 表示不归属于标准类别,自定义设备基本都用它。第五个 FILE_DEVICE_SECURE_OPEN 让系统在打开设备时套用设备的安全描述符,不加这一位等于任何用户都能打开你的设备。第六个 Exclusive 填 FALSE 允许多个句柄同时打开,填 TRUE 则只允许一个,串口类设备通常要独占。
\DosDevices\ 前缀可以简写成 \??\,两者等价。名字冲突会返回 STATUS_OBJECT_NAME_COLLISION,现象是第二次加载驱动时 AddDevice 直接失败,设备管理器里一片感叹号。原因一般是上一个实例没删干净——设备对象或符号链接泄漏了。开发期最简单的规避办法是每次改名字,但正解还是把卸载路径写对。
3.3 一个最小骨架的运行顺序
从编译完到能被用户态打开,中间有五道关卡,任何一道没过都到不了下一道。这个顺序建议照着走,不要跳步:
| 步骤 | 关键调用 | 期望结果 | 失败先看哪里 |
|---|---|---|---|
| 1. 加载驱动 | DriverEntry |
返回 STATUS_SUCCESS |
事件日志、返回值 |
| 2. 设备到达 | AddDevice |
设备对象创建成功 | 设备管理器设备状态 |
| 3. 符号链接 | IoCreateSymbolicLink |
名字不冲突 | \Device\ 下是否已有同名 |
| 4. 打开设备 | IRP_MJ_CREATE |
CreateFile 返回有效句柄 |
错误码 2(找不到)或 5(拒绝访问) |
| 5. 读写 | IRP_MJ_READ / WRITE |
返回正确字节数 | IoStatus.Information 有没有回填 |
第 4 步的错误码特别能说明问题。返回 2(ERROR_FILE_NOT_FOUND)基本就是符号链接没建,或者名字拼错;返回 5(ERROR_ACCESS_DENIED)则是安全描述符挡住了,检查 FILE_DEVICE_SECURE_OPEN 和 INF 里的安全段。这两个错误码能省掉大量盲猜。
4. IRP 分发链路:IRP_MJ_READ 从进来到 IoCompleteRequest 出去
4.1 分发函数的注册与 IRP 栈位置
用户态每一次 ReadFile、WriteFile、DeviceIoControl,到了内核都会变成一个 IRP 被投递到你的分发函数。分发函数拿到的只有两个东西:设备对象指针和 IRP 指针。要取参数必须往下挖栈位置:
c复制static NTSTATUS MyRead(PDEVICE_OBJECT DeviceObject, PIRP Irp)
{
/* 当前 IRP 栈位置,读写参数都在这里面 */
PIO_STACK_LOCATION stack = IoGetCurrentIrpStackLocation(Irp);
ULONG want = stack->Parameters.Read.Length; /* 用户态请求的字节数 */
ULONG offset = (ULONG)stack->Parameters.Read.ByteOffset.QuadPart; /* 起始偏移 */
UNREFERENCED_PARAMETER(DeviceObject);
/* 越界检查必须在拷贝之前做 */
if (offset >= BUFFER_SIZE) {
Irp->IoStatus.Status = STATUS_END_OF_FILE;
Irp->IoStatus.Information = 0;
IoCompleteRequest(Irp, IO_NO_INCREMENT);
return STATUS_END_OF_FILE;
}
ULONG avail = BUFFER_SIZE - offset;
ULONG n = (want < avail) ? want : avail;
/* 缓冲方式为 Buffered 时,数据从系统缓冲区进出 */
RtlCopyMemory(Irp->AssociatedIrp.SystemBuffer, g_buffer + offset, n);
Irp->IoStatus.Status = STATUS_SUCCESS;
Irp->IoStatus.Information = n; /* 必须回填实际传输字节数 */
IoCompleteRequest(Irp, IO_NO_INCREMENT);
return STATUS_SUCCESS;
}
IoGetCurrentIrpStackLocation 取的是属于本驱动的那一层栈位置。驱动分层时上一层可能压了参数下来,用 IoGetNextIrpStackLocation 取的才是下一层的位置,两个函数用混了参数全是垃圾值,且不会报错。
IoCompleteRequest 的第二个参数是优先级提升值,IO_NO_INCREMENT 表示不提升。对读写这类已经阻塞在等待上的线程来说,不提升会让调度延迟变大,但对多数自定义设备够用。想要低延迟可以把读请求用 IO_DISK_INCREMENT 之类提升,但别乱给,优先级提升用错反而会拖慢整机响应。
4.2 同步完成与挂起:IoCompleteRequest 的时机
IRP 有两条命运:当场处理完并完成,或者标记挂起稍后完成。两条路只能选一条,选错了就是蓝屏。
当场完成时,返回值必须和 IoStatus.Status 一致,并且 Information 要填实际字节数。系统看的是 IoStatus 里的值,返回值只是给上层的参考。只填 Status 不填 Information 的后果是用户态 ReadFile 拿到的 lpNumberOfBytesRead 是 0,明明数据已经拷进缓冲区了,调用方以为没读到。
挂起这条路要格外小心:
c复制/* 需要异步处理的分支:先标记挂起,再返回 STATUS_PENDING */
IoMarkIrpPending(Irp);
QueueWorkItem(Irp); /* 把 IRP 挂进自己的队列,交给工作线程 */
return STATUS_PENDING;
/* 工作线程处理完之后,只在这里完成一次 */
VOID OnWorkItemDone(PIRP Irp, NTSTATUS st, ULONG bytes)
{
Irp->IoStatus.Status = st;
Irp->IoStatus.Information = bytes;
IoCompleteRequest(Irp, IO_NO_INCREMENT);
}
IoMarkIrpPending 的作用是告诉 I/O 管理器"这个 IRP 我留着,别释放"。标记之后必须返回 STATUS_PENDING。反过来,如果不标记就直接返回 STATUS_PENDING,管理器会认为你会在当前调用栈里完成它,返回后立刻释放 IRP,你再调 IoCompleteRequest 就是操作已释放内存,蓝屏。另一种更隐蔽的错法:标记了 pending,却返回了 STATUS_SUCCESS,管理器认为已完成并释放,工作线程稍后再完成一次,同样蓝屏。
挂起之后必须有明确的完成触发点。中断、工作项、定时器、另一个线程的调用,任何一个都行,但一定要有。忘了完成的现象是用户态 ReadFile 永远不返回,进程卡死不报错,任务管理器里看着还挺正常。这种问题最难查,因为没有崩溃栈,只有一个不动的调用。我的习惯是每个 IoMarkIrpPending 后面紧跟着写一行注释,标明谁会负责完成它,事后对账时一眼就能看出漏了哪条路径。
4.3 缓冲区与传输长度校验
读写请求的缓冲区怎么取,取决于设备对象创建时定的缓冲方式:
| 缓冲方式 | 设置方式 | 数据在哪 | 谁负责拷贝 |
|---|---|---|---|
| Buffered | DO_BUFFERED_IO |
Irp->AssociatedIrp.SystemBuffer |
系统已拷好,驱动直接用 |
| Direct | DO_DIRECT_IO |
MmGetSystemAddressForMdlSafe(Irp->MdlAddress, ...) |
系统锁页,驱动映射后访问 |
| Neither | 两者都不设 | Irp->UserBuffer |
驱动自己用 ProbeForRead/Write 校验 |
Buffered 方式最省事,系统在进内核前已经把用户数据拷到内核缓冲区,拷贝方向按读写自动决定,驱动不需要管用户地址是否合法。代价是每次传输多一次内存拷贝,大数据量时性能掉得明显。Direct 方式省了这次拷贝,但驱动必须先调 MmGetSystemAddressForMdlSafe 把 MDL 映射成可访问地址,映射失败要返回 STATUS_INSUFFICIENT_RESOURCES。Neither 方式最自由也最危险,用户地址的合法性完全靠你自己 ProbeForRead、ProbeForWrite 兜,漏一次就是提权漏洞。
长度校验要在拷贝之前做,不能边拷边判。上面那段代码里先判 offset >= BUFFER_SIZE 再算可用长度,顺序反过来的话 BUFFER_SIZE - offset 会下溢成一个巨大的数,RtlCopyMemory 直接写到缓冲区外面去。这类整数下溢在内核里的后果不是抛出异常,是静默破坏相邻内存,然后在某个毫不相干的地方蓝屏。
返回 STATUS_BUFFER_OVERFLOW 表示"数据给了但没给全",此时 Information 要填实际返回的字节数,调用方据此知道要再读一次。别把 STATUS_BUFFER_OVERFLOW 和 STATUS_BUFFER_TOO_SMALL 混用:前者是部分成功,后者是一个字节都没给。用户态程序通常只处理前者,后者会当成硬错误。
5. 排查清单:IRQL、PnP 与加载失败的五个翻车现场
5.1 加载即蓝屏,崩溃栈停在 DriverEntry
现象:驱动刚被加载,系统立刻蓝屏,崩溃转储里的栈顶就是 DriverEntry 或它调用的某个函数。
原因通常有两类。一是 DriverEntry 里访问了还没初始化的指针,比如先取 DriverObject->DriverExtension->AddDevice 再判断 DriverExtension 是否为 NULL——非 PnP 驱动根本没有扩展区,这个 NULL 解引用直接崩。二是失败路径没回收资源,函数返回了错误码,系统不加载也不调用卸载,前面申请的池内存永久泄漏,反复加载几次后池耗尽。
解决:入口函数里只做注册和最小的资源申请,所有对象创建放到 AddDevice;每个 NT_SUCCESS 判断后面立刻处理失败分支,用统一的 goto cleanup 收口;在入口第一行加一句调试输出,确认崩溃到底发生在第几步。
5.2 IRQL_NOT_LESS_OR_EQUAL
现象:蓝屏代码 IRQL_NOT_LESS_OR_EQUAL,崩溃地址指向某个内核函数。
原因是在高 IRQL 上调用了只能在 PASSIVE_LEVEL 执行的 API,或者访问了被换出到页文件的内存。典型场景是分发函数里调了 KeWaitForSingleObject——如果当前 IRQL 已经是 DISPATCH_LEVEL,这个调用直接崩。另一种是用了分页池却在 DISPATCH_LEVEL 以上访问它。
解决:在分发函数入口用 KeGetCurrentIrql() 打一行输出,确认实际 IRQL 是多少;需要等待的操作全部挪到 PASSIVE_LEVEL 的工作线程里;跨 IRQL 共享的数据一律用非分页池分配。驱动里凡是注释写着"这里应该不会太高"的地方,全都是隐患。
5.3 设备管理器黄色感叹号,驱动装不上
现象:设备管理器里设备带黄色感叹号,属性页显示"该设备的驱动程序未被安装"或错误码 10、39、52。
原因按概率排:INF 里的 HardwareID 和设备实际上报的不一致(最常见);签名没做或测试签名没开;ServiceType 或 StartType 配错;.sys 文件没拷进 System32\drivers。错误码 52 基本就是签名问题,39 通常是 INF 里 ServiceBinary 路径写错导致文件找不到。
解决:先看设备管理器属性里的硬件 ID,逐字符和 INF 比对;确认 .sys 实际落盘位置和 ServiceBinary 一致;测试阶段用测试签名模式,发布前走正规签名;改完 INF 必须重新安装驱动,不能只替换 .sys——INF 里的服务配置不会因为换文件而更新。
5.4 用户态 ReadFile 一直不返回
现象:调用方阻塞在 ReadFile 上,进程不崩不报错,CPU 占用也不高,就是不动。
原因是 IRP 被标记挂起后没有完成,或者挂了 IoMarkIrpPending 却返回了 STATUS_SUCCESS 让管理器提前释放了 IRP。前者是漏了完成路径,后者是完成路径执行在已释放内存上——后者通常会蓝屏,但如果释放的内存没被立刻复用,可能表现为长时间不返回。
解决:给每个挂起点配一个计数器,进入时加一、完成时减一,卸载前必须归零;用调试器挂上符号后看有没有悬空的 IRP 没走完;每个 IoMarkIrpPending 后面强制写一行注释说明谁负责完成,没有明确负责人就不许标记。
5.5 卸载后立刻蓝屏
现象:sc stop 或者设备移除的瞬间蓝屏,崩溃点常在卸载例程或之后的某个回调。
原因是卸载顺序反了,或者还有 IRP 在路上。设备对象的删除顺序必须是:先删符号链接,再删设备对象;反过来删的话,符号链接指向一个已释放的设备对象,下一次有人用这个名字打开就是野指针。另外如果挂起的 IRP 还没完成就卸载,完成时回调的函数指针已经失效。
解决:卸载例程里先等所有挂起 IRP 归零,再删符号链接,最后删设备对象;DriverUnload 只释放驱动级资源,设备级资源在 AddDevice 对应的清理回调里释放;调试期可以在卸载路径上打日志,确认每一步都执行到了。
6. 分阶段验证:把驱动当黑匣子一层层拆开看
驱动调试最忌讳"全部写完再一起测"。内核里没有 try/catch 兜底,一次失败就是重启,一次重启就是几分钟。我现在的做法是把验证切成五段,每段只允许一个变量变化:
| 阶段 | 判定方法 | 失败先看哪里 |
|---|---|---|
| 编译通过 | 产物里有 .sys 和 .pdb |
链接错误里的符号名,多半是误用了用户态 CRT |
| 加载成功 | DriverEntry 返回成功,事件日志无错误 |
返回值、入口第一行的调试输出 |
| 设备创建 | 设备管理器里设备状态正常 | AddDevice 返回值、名字冲突 |
| 打开成功 | CreateFile 拿到有效句柄 |
错误码 2 看符号链接,5 看安全描述符 |
| 读写正确 | 返回字节数与预期一致 | IoStatus.Information 有没有回填 |
符号文件从第一段就要配好。调试器加载 .sys 时如果找不到同名 .pdb,栈回溯只能显示模块加偏移,一个 +0x2f1 摆在面前,你只能靠反汇编去猜是哪个分支。把 .pdb 和 .sys 放在同一目录,加载后确认符号状态是已加载,这一步花不了两分钟,能省下几小时。
还有一个习惯值得养成:每加一个新函数,先在入口打一行带函数名的调试输出,确认调用路径和你以为的一致。内核里的调用顺序经常和代码阅读顺序不一样,AddDevice 可能在 DriverEntry 返回之前就被调用,IRP_MJ_CLEANUP 可能在你没预料的时候先来。这些都能从输出顺序里看出来。
最后一条是我踩坑踩出来的:任何一次改完分发函数,不管改动多小,都强制走一遍"加载 → 打开 → 读一次 → 卸载"的完整回路,确认挂起计数归零再收工。有次只改了一行 Information 的赋值,觉得没必要重测,结果漏掉了 STATUS_BUFFER_OVERFLOW 分支的返回值,用户态读大文件时永远停在半截,查了整整一个下午。从那以后我每次改完驱动都强制走一遍完整回路,哪怕只改了一个常量。希望帮到你。
