简介：这份资源是《Developing Drivers with the Windows Driver Foundation》的PDF电子书，面向希望系统掌握Windows驱动开发的程序员与系统工程师，尤其适合具备一定C语言与操作系统基础、想深入内核态或用户态驱动编写的中高级开发者。全书由WDF团队核心成员撰写，从Windows驱动基础讲起，逐步展开WDF对象模型、驱动结构与初始化、即插即用与电源管理、I/O流与分派、同步与并发控制、驱动跟踪与诊断等核心主题，并分别覆盖KMDF与UMDF两种框架，还涉及DMA、中断、USB设备驱动、驱动编译安装、调试及静态驱动Verifier等进阶内容。资源包内仅含1个PDF文件，整体约8.25MB，篇幅完整、目录结构清晰，便于按章节检索学习。目前已有557人学习下载，可作为驱动开发入门到进阶的案头参考，帮助读者理解WDF统一驱动模型并掌握实际开发中的关键接口与最佳实践。

1. 从 WDF 入手：为什么 2025 年还要自己写 Windows 驱动

如果你最近在 Windows 上折腾过串口转 USB、自定义 HID 设备、虚拟串口或者 PCIe 采集卡，大概率会遇到一个尴尬局面：设备管理器里能识别，但厂商给的驱动要么是十年前 WDM 模板改的，要么干脆没有。这时候绕不开的一件事就是自己写驱动。而写 Windows 驱动，今天最稳的起点不是老 WDM，而是 Windows Driver Foundation，也就是 WDF。它把内核态里最容易翻车的电源管理、即插即用、I/O 队列这些黑匣子逻辑封装成框架，你只需要填业务回调。WDF 分两条线：KMDF 跑在内核态，适合真实硬件；UMDF 跑在用户态，适合协议转换和虚拟设备。这篇笔记按“先立住选型、再跑通最小驱动、最后排坑”的顺序展开，面向的是已经会 C 语言、装过 Visual Studio、但没正式写过驱动的工程师。读完你应该能判断自己的设备该走 KMDF 还是 UMDF，并且能在一台干净的 Windows 11 上把第一个驱动编译、签名、加载起来。

2. WDF 选型：KMDF 和 UMDF 到底怎么分

2.1 先看设备挂在哪条总线上

选型第一步不是看代码难度，而是看设备物理上挂在哪里。WDF 本身不决定总线，它只是框架，真正决定你走 KMDF 还是 UMDF 的是设备类型和访问方式。

我一般会先问一句：这个驱动会不会碰 MMIO 或 DMA？会，就 KMDF；不会，优先 UMDF。UMDF 最大的好处是调试成本低，驱动崩了顶多进程退出，不会直接 BSOD。但 UMDF 不能处理中断，也不能做 DMA，这是硬边界。

2.2 用 Visual Studio 建第一个 KMDF 工程

选型定了之后，落地第一步是把工程骨架搭起来。Windows 驱动开发现在基本绑在 Visual Studio + WDK 上，命令行也能编，但调试和签名还是 VS 顺手。

# 先确认 WDK 和 VS 版本匹配，常见做法是用 VS Installer 勾选 # "Desktop development with C++" 和 "Windows Driver Kit" # 装完后检查环境变量，能看到 WDK 的路径 where msbuild where signtool where inf2cat

上面三条命令是确认工具链是否就位。msbuild负责编译，signtool负责签名，inf2cat负责生成 catalog 文件。如果where找不到，说明 WDK 没装全，或者 VS 工作负载漏勾了。注意 WDK 版本必须和 SDK 版本对齐，比如 10.0.22621 的 SDK 配 10.0.22621 的 WDK，混装会出现Inf2Cat error这种玄学问题。

建工程时选 “Kernel Mode Driver, Empty (KMDF)”，VS 会自动生成Driver.c、Device.c、Queue.c和.inf文件。这个骨架已经包含DriverEntry、EvtDeviceAdd、EvtIoDefault三个核心回调，你只需要往里填逻辑。

2.3 最小 KMDF 驱动的三个回调

WDF 的编程模型是“框架管流程，你管回调”。一个能加载的最小 KMDF 驱动，核心就是三个函数。

// DriverEntry：驱动入口，创建 WDFDRIVER 对象 NTSTATUS DriverEntry(PDRIVER_OBJECT DriverObject, PUNICODE_STRING RegistryPath) { WDF_DRIVER_CONFIG config; WDF_DRIVER_CONFIG_INIT(&config, EvtDeviceAdd); // 注册设备添加回调 return WdfDriverCreate(DriverObject, RegistryPath, WDF_NO_OBJECT_ATTRIBUTES, &config, WDF_NO_HANDLE); } // EvtDeviceAdd：设备到达时创建 WDFDEVICE NTSTATUS EvtDeviceAdd(WDFDRIVER Driver, PWDFDEVICE_INIT DeviceInit) { WDFDEVICE device; NTSTATUS status = WdfDeviceCreate(&DeviceInit, WDF_NO_OBJECT_ATTRIBUTES, &device); if (!NT_SUCCESS(status)) return status; return WdfDeviceCreateDeviceInterface(device, &GUID_DEVINTERFACE_MYDEV, NULL); } // EvtIoDefault：处理应用层发来的读写请求 VOID EvtIoDefault(WDFQUEUE Queue, WDFREQUEST Request) { WdfRequestCompleteWithInformation(Request, STATUS_SUCCESS, 0); }

DriverEntry里WDF_DRIVER_CONFIG_INIT的第二个参数就是设备添加回调，框架在设备枚举时调用它。EvtDeviceAdd里WdfDeviceCreate创建的是逻辑设备对象，后面所有队列、中断、电源策略都挂在它下面。EvtIoDefault是默认 I/O 处理，实际项目里会按WdfRequestGetParameters里的Type分流到读、写、IOCTL 三个分支。参数上最容易错的是WDF_NO_OBJECT_ATTRIBUTES，新手常写成NULL，编译能过但运行时会崩，因为框架期望的是结构体指针。

3. 编译、签名、加载：把驱动跑起来的完整链路

3.1 编译产物和 inf 文件的关系

KMDF 工程编译完会得到.sys、.inf、.cat三个关键文件。.sys是驱动二进制，.inf是安装说明书，.cat是签名目录。很多人只关心.sys，结果装的时候报“找不到指定文件”，其实是.inf里的SourceDisksFiles段没写对。

; 最小 inf 的关键段 [Version] Signature="$WINDOWS NT$" Class=MyDeviceClass ClassGuid={...} ; 用 guidgen 生成 DriverVer=06/01/2025,1.0.0.0 [Manufacturer] %MyMfg%=MyMfg,NTamd64 [MyMfg.NTamd64] %MyDevice%=MyDevice_Install, USB\VID_1234&PID_5678 [MyDevice_Install.NT] CopyFiles=MyDevice_CopyFiles [MyDevice_CopyFiles] MyDriver.sys [MyDevice_Install.NT.Services] AddService=MyDriver,0x00000002,MyDevice_Service [MyDevice_Service] ServiceType=1 StartType=3 ErrorControl=1 ServiceBinary=%12%\MyDriver.sys

DriverVer的日期格式必须是月/日/年，写成2025/06/01会直接失败。USB\VID_1234&PID_5678是硬件 ID，要和设备实际上报的一致，用 USBView 或设备管理器“详细信息”里的硬件 ID 核对。StartType=3表示按需启动，改成0就是引导启动，调试阶段建议保持3，避免驱动有问题导致系统起不来。

3.2 测试签名和加载命令

开发阶段不可能每次都去微软签名，所以用测试签名模式。注意这一步需要管理员权限，而且会改系统启动配置。

# 开启测试签名模式，重启后生效 bcdedit /set testsigning on # 生成自签名证书 makecert -r -pe -ss PrivateCertStore -n "CN=MyDriverTest" MyDriverTest.cer # 签名 sys 文件 signtool sign /v /s PrivateCertStore /n MyDriverTest /t http://timestamp.digicert.com MyDriver.sys # 生成 cat 文件并签名 inf2cat /driver:. /os:10_X64 signtool sign /v /s PrivateCertStore /n MyDriverTest MyDriver.cat # 安装驱动 pnputil /add-driver MyDriver.inf /install

bcdedit /set testsigning on之后桌面右下角会出现“测试模式”水印，这是正常的。makecert生成的自签名证书要导入到“受信任的根证书颁发机构”和“受信任的发布者”，否则加载时会报0x800B0109。pnputil /add-driver是 Win10 之后推荐的安装方式，比右键 inf 安装更可靠，日志可以用pnputil /enum-drivers查看。

3.3 用 WinDbg 看第一个 DbgPrint

驱动加载成功不代表逻辑正确，最直接的验证手段是DbgPrint加 WinDbg。KMDF 驱动不能像用户态程序那样printf，输出走内核调试通道。

// 在 EvtDeviceAdd 里加一行 DbgPrint("MyDriver: DeviceAdd called, device=%p\n", device); // 编译时确保 inf 的 [MyDevice_Install.NT] 段有 // DebugLevel=0x0000000F 或者用 KdPrintEx

WinDbg 连接方式常见有两种：本机内核调试（需要双机或者虚拟机）和 USB 调试。我一般用 Hyper-V 虚拟机跑目标系统，宿主机 WinDbg 通过命名管道连过去。连上后DbgPrint的输出会直接出现在命令窗口。如果看不到输出，先检查DbgPrint的过滤级别，默认可能被屏蔽，用KdPrintEx指定DPFLTR_IHVDRIVER_ID更稳。

4. 避坑与排查：驱动加载失败的五个高频现场

4.1 设备管理器报“代码 52：无法验证数字签名”

现象是驱动装上了但设备带黄色感叹号，属性里写代码 52。原因通常是.cat文件没签名，或者签名证书没进受信任根。解决顺序是：先确认testsigning是 on，再确认.cat和.sys都签了，最后把证书手动导入“受信任的根证书颁发机构”。注意signtool签名时如果加了/t时间戳，离线环境会失败，去掉时间戳参数即可。

4.2 蓝屏 IRQL_NOT_LESS_OR_EQUAL

这是 KMDF 新手最常见的蓝屏。现象是加载驱动后立刻 BSOD，dump 指向你的EvtIoDefault。原因一般是在PASSIVE_LEVEL才能调的函数被放到了DISPATCH_LEVEL执行，比如WdfRequestComplete本身没问题，但你在它之前调了ExAllocatePool没加NonPagedPool。解决方法是检查所有内存分配和等待操作，确认 IRQL 要求，必要时用WdfObjectAllocateContext替代手动分配。

4.3 inf 安装报“找不到指定的文件”

现象是pnputil返回0x80070002。原因通常是.inf里CopyFiles段列出的文件名和实际.sys名字不一致，或者ServiceBinary的%12%路径写错。%12%代表System32\drivers，这是固定写法，不要改成绝对路径。解决方法是把.inf和.sys放同一目录，用inf2cat /driver:.重新生成 cat，再pnputil安装。

4.4 驱动加载后设备不出现

现象是pnputil显示安装成功，但设备管理器里没有新设备。原因可能是硬件 ID 不匹配，或者EvtDeviceAdd里WdfDeviceCreateDeviceInterface的 GUID 和应用程序请求的 GUID 不一致。解决方法是先用USBView确认设备上报的硬件 ID，再检查.inf的[Manufacturer]段是否覆盖了该 ID。如果是纯软件设备，需要手动用devcon创建节点。

4.5 WinDbg 连不上目标机

现象是 WinDbg 一直显示Waiting to reconnect。原因常见于虚拟机串口配置错误，或者目标机没开调试模式。解决方法是确认目标机bcdedit /dbgsettings输出正确，串口管道名字和 WinDbg 里填的一致。Hyper-V 下要用“命名管道”，不要用“COM 端口”，管道名两边必须完全相同，大小写敏感。

5. 进阶：用 WDF 做用户态 UMDF 驱动和自动化测试

UMDF 的工程结构和 KMDF 几乎一样，但运行在用户态，调试可以直接附加进程。我一般用它来做协议转换类设备，比如把自定义 USB 数据转成虚拟串口。关键区别是 UMDF 的DriverEntry叫FxDriverEntry，回调注册用WDF_DRIVER_CONFIG_INIT时第二个参数传EvtDeviceAdd不变，但WdfDeviceCreate之后不能调WdfInterruptCreate，因为用户态没有中断概念。

// UMDF 的 DriverEntry 写法 NTSTATUS FxDriverEntry(PWDFDRIVER Driver, PUNICODE_STRING RegistryPath) { WDF_DRIVER_CONFIG config; WDF_DRIVER_CONFIG_INIT(&config, EvtDeviceAdd); return WdfDriverCreate(Driver, RegistryPath, WDF_NO_OBJECT_ATTRIBUTES, &config, WDF_NO_HANDLE); }

UMDF 的.inf里ServiceType要改成2，表示用户态服务。加载后用sc query能看到服务状态，但设备节点还是在设备管理器里。调试时用 WinDbg 附加到WUDFHost.exe进程，直接下断点，比 KMDF 双机调试舒服得多。

自动化测试方面，我习惯用 PowerShell 脚本跑一遍加载、读写、卸载的完整流程，避免每次手动点设备管理器。

# 自动化加载卸载测试 pnputil /add-driver MyDriver.inf /install Start-Sleep -Seconds 2 $dev = Get-PnpDevice | Where-Object { $_.FriendlyName -like "*MyDevice*" } if ($dev.Status -ne "OK") { Write-Error "设备未就绪" } # 这里调用应用层测试程序 & ".\MyDriverTest.exe" pnputil /delete-driver MyDriver.inf /uninstall

这个脚本的关键是Start-Sleep给设备枚举留时间，Get-PnpDevice确认状态，最后pnputil /delete-driver清理。注意卸载前要先停掉占用设备的应用，否则会报0x80070005拒绝访问。我踩过的坑是脚本里没加-ErrorAction Stop，导致中间失败还继续跑，最后误判为通过。现在习惯在每个关键步骤后加状态检查，宁可脚本长一点，也不要假阳性。希望帮到你。

本文还有配套的精品资源，点击获取