使用 WDK 构建驱动程序

使用 Windows 驱动程序工具包 (WDK) 构建驱动程序。 WDK 8 和 WDK 8.1 与 Microsoft Visual Studio 完全集成。你可以使用 Visual Studio 开发环境构建驱动程序,也可以使用 Microsoft Build Engine (MSBuild) 直接从命令行构建驱动程序。 若要为 Windows 8.1、Windows 8、Windows 7 和 Windows Vista 构建驱动程序,请使用 Visual Studio 和 MSBuild。若要为 Windows XP 构建驱动程序,必须使用 Windows 7 WDK 和 Windows 构建实用工具 (Build.exe)。

要点  MSBuild 取代了在早期版本的 WDK 中使用的 Windows 构建实用工具 (Build.exe)。现在,WDK 使用你用来构建 Visual Studio 项目的相同编译器和构建工具。使用早期版本的 WDK 构建的驱动程序项目必须进行转换才能在 Visual Studio 环境中工作。你可以从命令行运行转换实用工具,也可以通过从现有的源创建新的 Visual Studio 项目来转换现有驱动程序。有关详细信息,请参阅从现有源文件创建驱动程序WDK 和 Visual Studio 构建环境

本部分介绍 以下内容:

使用 Visual Studio 构建驱动程序

构建驱动程序的方法与在 Visual Studio 中构建任何项目或解决方案的方法相同。当使用 Windows 驱动程序模板创建新的驱动程序项目时,该模板定义默认(活动)的项目配置以及默认(活动)的解决方案构建配置。

注意  必须升级使用 Windows 8 的 Windows 驱动程序工具包 (WDK) 创建的项目和解决方案文件,以与用于 Windows 8.1 和 Microsoft Visual Studio 2013 的 WDK 配合使用。打开项目或解决方案前,请先运行 ProjectUpgradeTool。ProjectUpgradeTool 将转换项目和解决方案,以便可以使用 WDK 8.1 构建它们。

有关管理和编辑构建配置的信息,请参阅Building in Visual Studio

选择解决方案构建配置、设置选项并构建驱动程序

默认的解决方案构建配置为“Win8 Debug”和“Win32”。 在早期版本的 WDK 中,此构建配置对应于使用“x86 已检查版本环境”构建驱动程序。

Ff554644.wedge(zh-cn,VS.85).gif选择配置并构建驱动程序的步骤

  1. 在 Visual Studio 中打开驱动程序项目或解决方案。
  2. 在“解决方案资源管理器”中右键单击解决方案,并选择“配置管理器”
  3. 从“配置管理器”中,选择与你感兴趣的构建类型相对应的活动解决方案配置(例如,“Win8 Debug”或“Win8 Release”)以及活动解决方案平台(例如,“Win32”)。
  4. 为驱动程序或驱动程序包配置项目属性。 可以为部署、驱动程序签署或其他任务设置属性。有关详细信息,请参阅为驱动程序和驱动程序包配置项目属性
  5. 从“构建”菜单中,单击“构建解决方案” (Ctrl+Shift+B)。

使用命令行构建驱动程序 (MSBuild)

可以使用“Visual Studio 命令提示符”窗口和 Microsoft 生成引擎 (MSBuild) 构建驱动程序。早期版本的 WDK 使用 Windows 构建实用工具 (Build.exe) 并为支持的每个构建配置提供单独的构建环境窗口。 现在,可以为所有构建配置使用“Visual Studio 命令提示符”窗口。

Ff554644.wedge(zh-cn,VS.85).gif使用 Visual Studio 命令提示符窗口构建驱动程序

  1. 打开一个“Visual Studio 命令提示符”窗口。

    从此窗口中,你可以使用 MSBuild.exe 通过指定项目 (.VcxProj) 或解决方案 (.Sln) 文件来构建任何 Visual Studio 项目。

  2. 导航到项目目录并为你的目标输入 MSbuild 命令。

    例如,若要使用默认的平台和配置构建名为 MyDriver.vcxproj 的全新的 Visual Studio 驱动程序项目,请导航到项目目录并输入以下 MSBuild 命令:

    msbuild /t:clean /t:build .\MyDriver.vcxproj 
    

    语法 - 若要指定特定的配置和平台,请使用以下命令语法:

    
    msbuild /t:clean /t:build ProjectFile /p:Configuration=configuration /p:Platform=platform     
    
    
    

    例如,以下命令针对“Win8 Debug”配置和“Win32”平台构建驱动程序:

    msbuild /t:clean /t:build .\MyDriver.vcxproj /p:Configuration="Win8 Debug" /p:Platform=Win32
    

Visual Studio 中的 WDK 项目构建配置

下表显示了 Visual Studio 中的项目构建配置如何与早期版本的 WDK(早于 WDK 8)中使用的构建环境相对应。

要点  若要为 Windows XP 构建驱动程序或为基于 ia64 的计算机构建驱动程序,必须使用 Windows 7 WDK。你可以从 Windows 开发人员中心 - 硬件网站下载 Windows 7 WDK。 要为 Windows Vista 构建驱动程序,必须使用 WDK 8 或 WDK 7。

项目配置项目平台等效的 Windows 7 WDK 构建环境窗口

Win8.1 调试

Win32、x64 或 ARM

在 Windows 7 WDK 或 WDK 8 中不可用

Win8.1 版本

Win32、x64 或 ARM

在 Windows 7 WDK 或 WDK 8 中不可用

Win8 Debug

Win32 或 x64

在 Windows 7 WDK 中不可用

Win8 Release

Win32 或 x64

在 Windows 7 WDK 中不可用

Win7 Debug

Win32

Win7 x86 已检查版本

Win7 Release

Win32

Win7 x86 免费内部版本

Win7 Debug

x64

Win7 x64 已检查版本

Win7 Release

x64

Win7 x64 免费内部版本

Vista Debug

Not available in WDK 8.1

Win32

Vista x86 已检查版本

Vista Release

Not available in WDK 8.1

Win32

Vista x86 免费内部版本

Vista Debug

Not available in WDK 8.1.

x64

Vista x64 已检查版本

Vista Release

Not available in WDK 8.1.

x64

Vista x64 免费内部版本

 

为驱动程序和驱动程序包配置项目属性

使用属性页,可以为驱动程序和驱动程序包配置和设置选项。可以选择配置驱动程序以便在构建解决方案时自动签署驱动程序,或者自动部署到远程测试计算机。

WDK 提供很多命令行工具,如构建过程中通常包含的 StampinfWPP 预处理器(WPP 跟踪)。这些工具不随 Visual Studio 一起分发。 为了将这些工具与 Visual Studio 构建环境结合使用,将这些工具作为 MSBuild 的 WDK 任务进行包装。 如果使用其中一个驱动程序模板或者转换现有的驱动程序,那么对于你的项目来说,这些属性页可能已存在。如果不是这样,那么当你向项目或解决方案中添加相关文件类型时,属性页会自动添加到你的项目(例如,消息编译器的 .mc 或 .man 文件)。有关详细信息,请参阅 WDK 和 Visual Studio 构建环境

可以为单个驱动程序或整个驱动程序包设置属性。下表显示了可以为驱动程序和驱动程序包专门配置的一些可用属性。

驱动程序项目属性驱动程序包属性

为单个驱动程序文件签署属性(请参阅签署驱动程序

为驱动程序包签署属性(请参阅签署驱动程序

驱动程序项目的计数器清单预处理器属性(对于 CTRPP

驱动程序包项目的部署属性(请参阅将驱动程序部署到测试计算机

驱动程序项目的驱动程序模型设置属性

驱动程序包项目的驱动程序验证程序属性

驱动程序项目的消息编译器属性

驱动程序包项目的 KMDF 验证程序属性

驱动程序项目的 Stampinf 属性

驱动程序包项目的 UMDF 验证程序属性

WPP 预处理器(WPP 跟踪)

驱动程序包项目的 Inf2Cat 属性(请参阅 Inf2Cat 工具)

 

构建驱动程序的疑难解答提示

以下提示可在你使用 WDK 和 Visual Studio 构建驱动程序时帮助你解决问题。

Ff554644.wedge(zh-cn,VS.85).gif使用 Visual Studio 中的选项增加构建输出详细信息的步骤

  1. 单击 Tools > Options
  2. 单击“项目和解决方案”文件夹并单击“生成并运行”
  3. 更改“MSBuild 项目构建输出详细信息”和“MSBuild 项目构建日志文件详细信息”。 默认情况下,这些都设置为“最少”。

相关主题

Building in Visual Studio
ProjectUpgradeTool
MSBuild
从现有源文件创建驱动程序
WDK 和 Visual Studio 构建环境
签署驱动程序
将驱动程序部署到测试计算机

 

 

显示:
© 2014 Microsoft