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

KMDF 驱动开发环境的核心由 Visual Studio、Windows Driver Kit (WDK) 和 目标测试机 三部分组成。本章将按标准流程完成环境搭建，并验证 KMDF 模板项目能否正确编译与部署。

2.1 环境架构总览

下图展示了开发机与目标机之间的典型协作关系：开发机负责代码编辑、编译和符号生成；目标机负责驱动加载、运行和调试。

2.2 Visual Studio 配置与 WDK 安装

2.2.1 安装步骤

1. 安装 Visual Studio 2022：选择“使用 C++ 的桌面开发”工作负载，确保包含“Windows 10/11 SDK”。
2. 下载并安装 WDK：从 Microsoft 官方渠道获取与目标 Windows 版本匹配的 WDK。安装程序会自动检测已安装的 Visual Studio 版本并集成扩展。
3. 验证集成：打开 Visual Studio，在“新建项目”中应能看到“Empty WDF Driver (KMDF)”模板。

2.2.2 版本兼容性对照表

2.3 KMDF 模板项目创建

使用 Visual Studio 的 KMDF 模板可以快速生成符合框架规范的驱动骨架，包含 DriverEntry、EvtDriverDeviceAdd 和 INF 文件。

2.3.1 创建流程

1. 打开 Visual Studio，选择 文件 → 新建 → 项目。
2. 搜索 KMDF，选择 Empty WDF Driver (KMDF) 模板。
3. 填写项目名称（如 MyKMDFDriver）和位置，点击“创建”。
4. 项目生成后，检查解决方案资源管理器中的文件结构：

MyKMDFDriver/
├── Driver.c          # 驱动入口与设备添加回调
├── Driver.h          # 函数声明与数据结构
├── MyKMDFDriver.inf  # 驱动安装信息文件
├── MyKMDFDriver.vcxproj  # 项目配置
└── ...

2.3.2 模板代码核心结构

以下为 Driver.c 中的关键框架代码，展示了 KMDF 驱动的标准初始化流程：

#include <ntddk.h>
#include <wdf.h>

DRIVER_INITIALIZE DriverEntry;
EVT_WDF_DRIVER_DEVICE_ADD KmdfDriverEvtDeviceAdd;

NTSTATUS
DriverEntry(
    _In_ PDRIVER_OBJECT  DriverObject,
    _In_ PUNICODE_STRING RegistryPath
)
{
    WDF_DRIVER_CONFIG config;
    NTSTATUS status;

    WDF_DRIVER_CONFIG_INIT(&config, KmdfDriverEvtDeviceAdd);

    status = WdfDriverCreate(
        DriverObject,
        RegistryPath,
        WDF_NO_OBJECT_ATTRIBUTES,
        &config,
        WDF_NO_HANDLE
    );

    return status;
}

NTSTATUS
KmdfDriverEvtDeviceAdd(
    _In_    WDFDRIVER       Driver,
    _Inout_ PWDFDEVICE_INIT DeviceInit
)
{
    // 设备初始化与 I/O 队列创建
    WDFDEVICE device;
    NTSTATUS status;

    status = WdfDeviceCreate(&DeviceInit, WDF_NO_OBJECT_ATTRIBUTES, &device);
    if (!NT_SUCCESS(status)) {
        return status;
    }

    // 创建默认 I/O 队列（后续章节详解）
    return status;
}

2.4 目标机配置

目标机需要开启测试签名模式并配置内核调试，才能加载和调试开发机编译的驱动。

2.4.1 启用测试签名

1. 以管理员身份打开命令提示符，执行：

bcdedit /set testsigning on

2. 重启目标机。
3. 验证：桌面右下角出现“测试模式”水印。

2.4.2 配置内核调试

根据连接方式选择调试传输：

2.4.3 目标机配置流程图

2.5 编译与部署验证

完成环境搭建后，通过以下步骤验证工具链是否正常工作：

1. 在 Visual Studio 中选择 Release | x64 配置。
2. 右键项目 → 生成。成功后在输出目录得到 .sys 文件和 .inf 文件。
3. 将驱动文件复制到目标机，使用 devcon 或 pnputil 安装：

pnputil /add-driver MyKMDFDriver.inf /install

4. 在设备管理器中确认驱动已加载，或通过 WinDbg 查看调试输出。

2.6 常见问题与排查