KMDF框架中断处理与DMA传输性能调优 - 第1节

1.1 KMDF 框架简介

Kernel-Mode Driver Framework (KMDF) 是微软 Windows Driver Foundation (WDF) 家族中面向内核模式驱动程序的框架。它封装了 WDM (Windows Driver Model) 的复杂性，为驱动开发者提供基于 对象 和 事件回调 的编程模型。KMDF 自动处理 PnP 状态机、电源管理、I/O 队列等底层基础设施，使开发者能专注于硬件逻辑。

KMDF 与 WDM 的对比

1.2 KMDF 与 WDF 的关系

WDF 是微软新一代驱动框架的总称，包含两个分支：

• KMDF — 内核模式驱动框架，运行在 Ring 0，用于硬件驱动、文件系统过滤等。
• UMDF — 用户模式驱动框架，运行在 Ring 3，用于协议驱动、传感器等非性能关键场景。

两者共享相同的 对象层次结构 和 句柄模型（WDFOBJECT），但 KMDF 拥有对中断、DMA、直接内存访问的完全控制权，是高性能硬件驱动的首选。

1.3 KMDF 驱动模型架构

KMDF 驱动围绕 WDF 对象树 构建。每个对象由框架分配、初始化，并通过句柄（WDFXXX_HANDLE）引用。核心对象包括：

• WDFDRIVER — 驱动对象，每个驱动唯一。
• WDFDEVICE — 设备对象，代表一个物理或逻辑设备。
• WDFQUEUE — I/O 队列对象，管理 IRP 的分发与排队。
• WDFINTERRUPT — 中断对象，绑定中断服务例程 (ISR)。
• WDFDMAENABLER / WDFDMATRANSACTION — DMA 相关对象，用于总线主控 DMA 传输。

对象层次与事件回调

KMDF 采用 “框架驱动” 模式：框架在特定时机（如设备启动、I/O 到达、中断触发）调用开发者注册的 EvtXxx 回调函数。开发者只需在回调中填充硬件逻辑，无需手动处理 IRP 分发。

1.4 KMDF 驱动开发环境搭建

搭建 KMDF 开发环境需要以下组件：

环境验证步骤

1. 安装 Visual Studio 并确保 Windows 驱动程序工具集 工作负载已勾选。
2. 安装 Windows WDK（安装程序会自动检测 VS 实例并集成）。
3. 打开 VS，新建项目 → 搜索 “KMDF” → 选择 “Kernel Mode Driver, Empty (KMDF)” 模板。
4. 编译默认生成的 .sys 文件，确认无错误。
5. 在目标机上运行 bcdedit /set testsigning on 并重启，使用 sc create 或 devcon 安装驱动。

典型 KMDF 项目结构

MyKmdfDriver/
├── Driver.c              # DriverEntry / EvtDriverDeviceAdd
├── Device.c              # EvtDevicePrepareHardware / EvtDeviceReleaseHardware
├── Queue.c               # EvtIoRead / EvtIoWrite / EvtIoDeviceControl
├── Interrupt.c           # EvtInterruptIsr / EvtInterruptDpc
├── Dma.c                 # EvtDmaCompletion / EvtDmaFillBuffer
├── Trace.h               # WPP 软件跟踪宏定义
├── MyKmdfDriver.inf      # 驱动安装 INF 文件
├── Makefile              # 构建入口 (WDK 传统)
└── Sources               # 源文件列表 (WDK 传统)

1.5 本章小结