开展Windows驱动开发需优先选用KMDF框架：明确区分KMDF/WDM技术路径，严格遵循内核模式执行规范，通过WDF封装简化IRP/电源/PnP处理，迁移时重构设备对象与中断逻辑，并用Verifier+WinDbg定位生命周期误用等蓝屏问题。
如果您正在开展Windows驱动开发工作，需要在内核模式下构建稳定、可维护的驱动程序，则必须明确区分传统内核模式驱动（KMDF/WDM）与现代WDF框架（KMDF/UMDF）的技术路径。以下是针对该方向的关键实践步骤：
一、理解内核模式驱动的基本执行环境
Windows内核模式驱动运行在Ring 0特权级，直接访问硬件和系统核心资源，因此必须严格遵循内存管理、同步机制与IRP处理规范。错误的指针解引用或未同步的共享数据访问将导致系统崩溃（BSOD）。
1、确认目标Windows版本支持的驱动模型：Windows 10 1903及以上版本默认要求使用WDF框架，禁用旧式WDM裸驱动签名提交。
2、安装WDK（Windows Driver Kit）与对应版本的Visual Studio，并在项目属性中启用“Driver”配置类型。
3、使用WppTraceControl宏启用ETW事件跟踪，在驱动入口函数DriverEntry中注册WPP初始化语句。
二、选择KMDF作为首选内核驱动框架
KMDF（Kernel-Mode Driver Framework）封装了大量底层IRP分发、电源管理、即插即用状态机逻辑，显著降低手动实现PDO/FDO堆栈与IRP路由的复杂度。
1、在WDK模板中新建“KMDF Driver”项目，确保生成的driver.h包含#include <wdf.h>及WDF_DRIVER_CONFIG_INIT调用。
2、将设备对象创建逻辑移入EvtDriverDeviceAdd回调，使用WdfDeviceCreate替代IoCreateDevice。
3、通过WdfDeviceConfigureRequestDispatching显式声明对特定IRP主功能码（如IRP_MJ_READ）的处理方式，避免框架默认转发至未实现例程而触发失败完成。
三、迁移遗留WDM驱动至KMDF结构
将已有WDM驱动重构为KMDF风格，需剥离原始DriverEntry中的设备对象创建与IRP派遣表注册，转由KMDF运行时自动管理设备生命周期和I/O队列。
1、保留原WDM驱动的硬件访问逻辑（如PortIO、MMIO地址映射），但将其封装进KMDF设备上下文结构体中，通过WdfObjectGetTypedContext获取。
2、将原MajorFunction[IRP_MJ_PNP]处理逻辑替换为EvtDeviceD0Entry与EvtDeviceD0Exit回调，确保电源状态转换时正确使能/禁用硬件模块。
3、使用WdfInterruptCreate替代IoConnectInterrupt，并指定WDF_INTERRUPT_CONFIG中AutomaticSerialization字段为TRUE，交由框架处理中断服务例程（ISR）与延迟过程调用（DPC）的同步。
四、配置WDF驱动的即插即用与电源策略
KMDF通过设备堆栈对象（DSO）自动参与PNP/电源状态迁移，但需显式配置策略以匹配硬件行为，例如禁止系统在设备活动时进入S3睡眠状态。
1、在EvtDriverDeviceAdd中调用WdfDeviceInitSetPowerPolicyOwnership，传入WdfFalse以启用框架默认电源策略。
2、若设备不支持D0低功耗子状态，调用WdfDeviceInitSetPowerNotPageable防止系统在D0状态下将驱动代码页换出。
3、在EvtDevicePrepareHardware中读取ACPI _PS0/_PS3方法返回值，通过WdfDeviceAssignS0IdleSettings设置IdleCaps为IdleCannotWakeFromS0，强制系统在空闲时转入S3而非S0低功耗。
五、调试KMDF驱动的典型蓝屏故障点
KMDF驱动崩溃常源于框架对象生命周期误用，例如在设备已删除后继续调用WdfObjectReference，或在非DISPATCH_LEVEL下调用需提升IRQL的API。
1、启用Verifier并勾选“Special Pool”、“Pool Tracking”、“I/O Verification”，重启后复现问题，通过WinDbg分析!analyze -v输出定位非法内存访问位置。
2、检查所有WdfXXXCreate调用是否检查返回NTSTATUS，严禁忽略STATUS_INSUFFICIENT_RESOURCES等失败码直接使用未初始化句柄。
3、在EvtDeviceReleaseHardware中调用WdfInterruptStop前，确保已完成所有挂起的DPC并等待其执行完毕，使用WdfInterruptSynchronize包裹临界资源释放逻辑。
