2. 开发环境搭建：Visual Studio 配置、WDK 安装、KMDF 项目模板创建

在开始 KMDF 驱动开发之前，搭建一个正确且稳定的开发环境是首要任务。本章将引导你完成从 Visual Studio 配置、WDK 安装到创建第一个 KMDF 项目模板的完整流程。一个标准的环境能够避免后续开发中 90% 的编译与链接问题。

2.1 环境概览与版本对应关系

KMDF 驱动开发依赖 Visual Studio 与 WDK 的严格版本匹配。下表列出了当前主流的开发环境组合，建议初学者优先选择 VS 2022 + WDK for Win 11 的组合，以获得最长的支持周期。

2.2 安装步骤详解

安装过程遵循“先 VS，后 WDK”的顺序。错误的安装顺序可能导致 WDK 集成失败，需要重新修复安装。

2.2.1 安装 Visual Studio

1. 选择工作负载： 在 VS Installer 中，必须勾选 “使用 C++ 的桌面开发” 工作负载。
2. 可选组件： 在右侧摘要中，确保包含 “Windows 10 SDK (10.0.xxxxx)”。WDK 安装程序会依赖此 SDK。
3. 安装路径： 建议使用默认路径，避免因路径空格或权限问题导致 WDK 扩展加载失败。

2.2.2 安装 Windows 驱动程序工具包 (WDK)

1. 下载匹配版本： 从 Microsoft 官方文档或 MSDN 下载与 VS 版本匹配的 WDK ISO 或 exe。
2. 执行安装： 以管理员身份运行安装程序。WDK 会自动检测已安装的 VS 版本并集成扩展。
3. 验证集成： 安装完成后，打开 VS，在“新建项目”对话框中搜索“Driver”，应能看到 “Empty WDF Driver (KMDF)” 或类似模板。

2.3 KMDF 项目模板创建与结构解析

成功安装环境后，我们来创建第一个 KMDF 项目。这个模板将自动生成必要的文件，包括驱动入口、设备控制回调以及 INF 文件。

2.3.1 创建项目步骤

1. 打开 Visual Studio，选择 “创建新项目”。
2. 在搜索框中输入 “KMDF”，选择 “Empty WDF Driver (KMDF)” 模板。
3. 配置项目名称（例如：KmdfInterruptDemo）和位置。
4. 点击“创建”。VS 将生成一个包含 Driver.c、Driver.h 和 .inf 文件的基础项目。

2.3.2 模板文件结构

生成的模板虽然简单，但包含了 KMDF 驱动的核心骨架。下表列出了关键文件及其作用：

2.4 核心代码骨架与 KMDF 初始化流程

理解模板生成的 DriverEntry 函数是掌握 KMDF 的第一步。下面的代码展示了驱动初始化的标准流程，以及如何配置 WDF 驱动对象。

// Driver.c - KMDF 驱动入口
#include <ntddk.h>
#include <wdf.h>
#include "Driver.h"

// 设备添加回调函数声明
NTSTATUS
KmdfInterruptDemoEvtDeviceAdd(
    _In_    WDFDRIVER       Driver,
    _Inout_ PWDFDEVICE_INIT DeviceInit
    );

// 驱动入口点
NTSTATUS
DriverEntry(
    _In_ PDRIVER_OBJECT  DriverObject,
    _In_ PUNICODE_STRING RegistryPath
    )
{
    NTSTATUS status;
    WDF_DRIVER_CONFIG config;

    KdPrint(("KmdfInterruptDemo: DriverEntry\n"));

    // 1. 初始化 WDF_DRIVER_CONFIG 结构
    WDF_DRIVER_CONFIG_INIT(
        &config,
        KmdfInterruptDemoEvtDeviceAdd  // 指定 EvtDeviceAdd 回调
        );

    // 2. 创建 WDF 驱动对象
    status = WdfDriverCreate(
        DriverObject,
        RegistryPath,
        WDF_NO_OBJECT_ATTRIBUTES,
        &config,
        WDF_NO_HANDLE
        );

    if (!NT_SUCCESS(status)) {
        KdPrint(("KmdfInterruptDemo: WdfDriverCreate failed 0x%x\n", status));
        return status;
    }

    KdPrint(("KmdfInterruptDemo: DriverEntry completed successfully\n"));
    return status;
}

// EvtDeviceAdd 回调 - 当 PnP 管理器检测到设备时调用
NTSTATUS
KmdfInterruptDemoEvtDeviceAdd(
    _In_    WDFDRIVER       Driver,
    _Inout_ PWDFDEVICE_INIT DeviceInit
    )
{
    NTSTATUS status;
    WDFDEVICE device;

    UNREFERENCED_PARAMETER(Driver);

    KdPrint(("KmdfInterruptDemo: EvtDeviceAdd\n"));

    // 3. 创建设备对象
    status = WdfDeviceCreate(
        &DeviceInit,
        WDF_NO_OBJECT_ATTRIBUTES,
        &device
        );

    if (!NT_SUCCESS(status)) {
        KdPrint(("KmdfInterruptDemo: WdfDeviceCreate failed 0x%x\n", status));
        return status;
    }

    KdPrint(("KmdfInterruptDemo: Device created successfully\n"));
    return status;
}

2.5 KMDF 驱动初始化流程 SVG 图

下图展示了从 DriverEntry 到设备创建完成的完整初始化流程，帮助你理解 KMDF 框架如何接管传统的 WDM 驱动模型。

2.6 环境验证与常见问题排查

搭建完成后，建议执行一次编译验证环境是否正常工作。在 VS 中按 Ctrl+Shift+B 编译项目。如果编译成功，输出窗口应显示 Build succeeded。

2.6.1 常见错误与解决方案

2.7 本章小结