WDTF 运行时库

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

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

  • 复制文件。

  • 添加注册表项。

  • 注册 WDTF 对象。

  • 安装和卸载日志文件。

WDTF 运行时库包含有助于分析和运行测试的工具。

工具或命令脚本的名称 DESCRIPTION
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 命令的选项。

选项 DESCRIPTION
/l* 文件名 将所有消息和错误写入文件、 文件名
WDTFDIR=CustomInstallationDirectory 指定 WDTF 运行时的目标目录。 默认 WDTFDir %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF
WDTF_SKIP_MACHINE_CONFIG=[1 | 2] 指定 1 以跳过将 cscript.exe 设置为默认脚本引擎的设置。 指定 2 以跳过启用 AC 和 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)运行时库,选择并按住(或右键单击),然后选择“ 卸载”。