使用 WDK 开发、测试和部署用于Windows的驱动程序。
- 在 Windows 7 及更高版本上安装并运行最新发布的 WDK。
- 使用最新版本的 WDK 为 Windows 10、Windows Server 2016 及更高版本的客户端和服务器版本生成驱动程序。
重要
- 使用最新的 WDK 28000.2526 和 Visual Studio 2026 进行驱动程序开发。 若要面向较旧版本的 Windows,请参阅使用最新Windows 驱动程序工具包 (WDK)生成早期操作系统版本的驱动程序。
- 如果要继续使用 Visual Studio 2022 或升级到 Visual Studio 2026 时遇到问题,请使用 Other WDK 下载中提供的 WDK 26100.6584。
- 正在查找早期 WDK 版本? 访问 其他 WDK 下载
加入 Windows 预览体验计划以获取 WDK Insider Preview 内部版本。 有关 Windows Insider Preview 版本的安装说明,请参阅 Windows 驱动程序工具包 (WDK) 预览版的安装说明。
WDK NuGet 包支持
从版本 10.0.26100.1 开始,WDK 作为 NuGet 包提供。 直接从Visual Studio内的 nuget.org 访问和使用这些包。 WDK NuGet 包提供了一种获取和更新 WDK 的便捷方法。 它还管理依赖项(如 SDK),帮助保持驱动程序开发工具链的当前状态。 有关详细信息,请参阅使用 NuGet 安装最新的 WDK。
ARM64 支持
从 WDK 版本 10.0.26100.1 开始,WDK 支持在 ARM64 计算机上开发、测试和部署驱动程序。 可以在 ARM64 硬件上本机安装和运行 WDK 和 EWDK。 WDK 还继续支持在 ARM64 硬件上模拟 x86 KMDF 和 UMDF 2 驱动程序。 现在可以从 ARM64 和 x64 主机调试驱动程序并将其部署到 ARM64 目标计算机。 在 ARM64 计算机上安装 WDK 或 EWDK 时,该过程会自动识别并安装所有必要的依赖项,包括生成工具、二进制文件和库。
步骤 1:安装 Visual Studio 2026
Visual Studio 2026 社区版、专业版或企业版支持此版本的驱动程序开发。
安装 Visual Studio 2026 时,选择
- 已针对 Spectre 漏洞缓解的 C++ x64/x86 库(适用于最新的 MSVC)
- 针对 ARM64/ARM64EC 的 C++ Spectre 漏洞缓解库(最新 MSVC)
- 带有 Spectre 缓解措施的 C++ ATL,用于 x64/x86(最新 MSVC)
- 使用最新的 MSVC 和 Spectre 漏洞缓解措施的 ARM64/ARM64EC C++ ATL
- 具有 Spectre 缓解措施的 x64/x86 C++ MFC(最新 MSVC)
- C++ MFC 使用带有 Spectre 缓解措施的 ARM64/ARM64EC(最新 MSVC)
- Windows 驱动程序工具包 (WDK)
提示
请使用搜索框查找“Spectre”来快速查看这些组件。
注意
Desktop 开发使用 C++ 的工作负载不包含 Windows SDK 10.0.28000.1。
步骤 2:安装 SDK
安装Visual Studio不会下载最新的 SDK 版本。 使用以下链接安装最新的 SDK 版本:
所提供的 SDK 和 WDK 链接具有匹配的版本号,这对套件的协同工作始终必不可少。 如果你决定安装自己的 SDK/WDK 组合,可能是针对其他 Windows 版本,请确保版本号匹配。 有关详细信息,请参阅 工具包版本控制。
步骤 3:安装 WDK
从版本 17.11.0 开始,WDK VSIX 作为单个组件包含在Visual Studio中。 安装 WDK 之前,安装程序会检查是否已安装兼容版本的 VSIX。 如果安装程序找不到 WDK VSIX,它会提示你安装它。 若要安装 WDK VSIX,请启动Visual Studio安装程序, 选择 Modify,转到 Individual Components 选项卡,添加 Windows 驱动程序工具包 (WDK),然后选择 Modify。
提示
如果在Visual Studio中找不到驱动程序项目模板,WDK Visual Studio 扩展未正确安装。 若要解决此问题,请启动 Visual Studio Installer,选择 Modify,在 Individual Component 选项卡中添加 Windows 驱动程序工具包 (WDK),然后选择 Modify。
企业 WDK (EWDK)
可以下载 EWDK,而不是单独下载 Visual Studio、SDK 和 WDK。 EWDK 是用于生成驱动程序的独立自包含命令行环境。 它包括Visual Studio生成工具、SDK 和 WDK。
EWDK 的最新公共版本包含 Visual Studio 2026 生成工具 18.3.0 和 MSVC 工具集 v14.50。
EWDK 还需要 .NET Framework 版本 4.7.2。 有关 .NET Framework 的其他要求的详细信息,请参阅 .NET Framework 系统要求。
下载 ISO 后,使用以下步骤设置生成环境:
- 从驱动器卷挂载 EWDK ISO。 目前不支持网络共享路径。
- 运行 LaunchBuildEnv.cmd。
- 在步骤 2 中创建的环境中,键入“SetupVSEnv”,然后按“Enter”。
- 使用完整文件路径从同一环境启动 devenv.exe 。 例如:
"C:\Program Files\Microsoft Visual Studio\2026\%Community|Professional|Enterprise%\Common7\IDE\devenv.exe" - 使用完生成环境后,可能想弹出 ISO。
可以选择将Visual Studio接口与 EWDK 中提供的生成工具配合使用。 若要使用Visual Studio接口,请确保Visual Studio主版本与 EWDK 中Visual Studio生成工具的版本匹配。 例如,Visual Studio 2026 可与包含 VS18.X 生成工具的 EWDK 配合使用。 有关 Visual Studio 2026 版本号的列表,请参阅 Visual Studio 2026 版本。
套件版本控制
完整的套件内部版本字符串包括最后两个部分,即内部版本号和 QFE(快速修复工程)值。 例如,10.0.22621.2428 的内部版本号为 22621,QFE 值为 2428。
要生成驱动程序,SDK 安装的内部版本号必须与 WDK 安装的内部版本号一致。 除非驱动程序使用的功能仅在后续 QFE 附带的标头中可用,否则 QFE 值无需匹配。
查看本地安装的工具包的完整生成字符串的快速方法是转到Windows设置(Win+I),导航到 Apps, 然后installed apps,然后在 Search 框中键入 kit。 完整的构建字符串显示在套件名称右边。 转到C:\Program Files (x86)\Windows Kits\10\Include时,显示的 QFE 被硬编码为.0。 因此,目录名称不是检查 QFE 标识符的可靠方法。 安装套件时,新安装将替换以前任何具有相同版本号的现有安装。 安装 Visual Studio 并选择 桌面开发使用 C++ 的工作负载时,如果安装包包含 Windows SDK,则右侧的“摘要”窗格还会显示 QFE 的 .0 硬编码。
用于Windows的驱动程序示例
通过以下方式之一下载驱动程序示例:
- 转到 GitHub 上的驱动程序示例页,选择 Clone 或下载,然后选择 Download ZIP。
- 下载适用于 Visual Studio 的
GitHub 扩展,然后连接到GitHub存储库。 - 浏览 Microsoft 示例门户上的驱动程序示例。
相关下载
- 下载 WDK Insider Preview
- 下载以前版本的 WDK
- 下载Windows评估和部署工具包(Windows ADK)
- 下载 Windows HLK
- 加载Windows调试工具 (WinDbg)
- 下载 Windows 符号包