WDTF 运行时库

WDTF 运行时库作为 Windows 驱动程序工具包 (WDK) 的一部分提供。 安装 WDK 时,还会安装 Windows 驱动程序测试框架 (WDTF) 。 用于测试和开发的模板和示例文件随 WDK 一起安装。 需要在要运行基于 WDTF 的测试的任何系统上安装 WDTF 运行时库。 这包括 WDK 中提供的测试和使用 WDK 测试模板编写的测试。

WDK 还包括一个单独的安装包 (*.msi) ,可用于在测试计算机上安装 WDTF 运行时。 MSI 执行以下操作:

  • 复制文件。

  • 添加注册表项。

  • 注册 WDTF 对象。

  • 安装和卸载日志文件。

WDTF 运行时库包含可帮助进行会审和运行测试的工具。

工具或命令脚本的名称 说明
CheckWDTFInstall.cmd 验证是否已正确安装 WDTF。 运行此命令将创建文件 CheckWDTFInstall.log,其中包含有关所有已安装的 WDTF 组件的信息。
DisplayDeviceClass.vbs 显示当前系统上存在的设备类信息。 同时显示类 GUID 和类友好名称。 在尝试创建查找特定类设备的 /DQ 查询时非常有用。
DisplayDeviceDataFields.cmd 显示当前系统上存在的设备类信息。 同时显示类 GUID 和类友好名称。 在尝试创建查找特定类设备的 /DQ 查询时非常有用。
DisplayDevices.vbs 显示由 /DQ 参数表示的每个设备的相关信息,默认值为系统中的所有设备。
DisplayDevicesWithWDTFilters.vbs 显示安装了其中一个 WDTF 筛选器驱动程序的任何设备。 WDTF 有三个筛选器驱动程序:EDT、IOSPY 或按钮驱动程序。
DisplayDeviceTree.vbs 显示当前系统的设备树。
DisplaySystemDataFields.cmd 显示所有系统命名空间及其拥有的字段。

如何安装 WDTF 运行时库

设置用于部署的测试计算机时,WDTF 运行时库安装在测试计算机上。 按照 为驱动程序部署和测试预配计算机 (WDK 10 和 WDK 8.1)

还可以手动安装 WDTF 运行时库。

在测试计算机上安装 WDTF (首选方法)

  1. 安装 Visual Studio,然后安装 WDK。

  2. 配置用于测试的远程计算机。 在 Visual Studio 中,选择“ 驱动程序 ”菜单,指向 “测试”,然后选择“ 配置计算机”。

在测试计算机上手动安装 WDTF (替代方法)

  1. 在用于开发的计算机上安装 Visual Studio 和 WDK。

  2. 将 WDTF 安装文件从安装了 WDK 的计算机复制到测试计算机。 WDTF 安装文件 (*.msi和 *.cab 文件) 位于开发系统上的 %programfiles%\Windows Kits\10\Testing\Runtimes 目录中。 复制目录中与测试计算机的体系结构匹配的所有文件。

  3. 在测试计算机上,使用提升的权限打开命令提示符窗口 (以 管理员身份) 运行 ,然后导航到包含 WDTF 安装文件的目录。 运行以下命令之一来安装 WDTF。

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi"

-或-

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x86_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x86_en-us.msi"

下表介绍了可用于 msiexec 命令的选项。

选项 说明
/我* 文件名 将所有消息和错误写入文件、 文件名
WDTFDIR=CustomInstallationDirectory 指定 WDTF 运行时的目标目录。 默认 WDTFDir 为 %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF
WDTF_SKIP_MACHINE_CONFIG=[1 | 2] 指定 1 可跳过将cscript.exe设置为默认脚本引擎。 指定 2 以跳过启用交流和 DC RTC 唤醒。
/? 显示有关msiexec.exe选项的帮助。

示例

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi" /l* OneCoreUap_WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi" /l* WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1

如何确定计算机上是否安装了 WDTF 运行时库

可以通过在测试计算机上运行命令脚本来验证是否已正确安装 WDTF。 运行此命令将创建文件 CheckWDTFInstall.log,其中包含有关所有已安装的 WDTF 组件的信息。

  1. 在测试计算机上打开命令提示符窗口。

  2. 运行 %WDTFDir%\Tools\CheckWDTFInstall.cmd

  3. 打开日志文件 CheckWDTFInstall.log 并检查结果。

如何卸载 WDTF 运行时库

设置用于部署的测试计算机时,按照 为驱动程序部署和测试设置计算机的说明 (WDK 10) ,WDTF 运行时库安装在目标计算机上。

可以通过从目标计算机中删除预配来删除 WDTF 运行时库。 有关详细信息,请参阅 从目标计算机中删除预配

还可以手动卸载 WDTF 运行时库。

在测试计算机上手动卸载 WDTF

  1. 在测试计算机上,转到 “设置” ,然后选择“ 应用”。

  2. “程序和功能”中,找到“Windows 驱动程序测试框架 (WDTF) 运行时库”,选择并按住 (或右键单击“) ”,然后选择“ 卸载”。