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 (首选方法)
安装 Visual Studio,然后安装 WDK。
配置用于测试的远程计算机。 在 Visual Studio 中,选择“ 驱动程序 ”菜单,指向 “测试”,然后选择“ 配置计算机”。
在测试计算机上手动安装 WDTF (替代方法)
在用于开发的计算机上安装 Visual Studio 和 WDK。
将 WDTF 安装文件从安装了 WDK 的计算机复制到测试计算机。 WDTF 安装文件 (*.msi和 *.cab 文件) 位于开发系统上的 %programfiles%\Windows Kits\10\Testing\Runtimes 目录中。 复制目录中与测试计算机的体系结构匹配的所有文件。
在测试计算机上,使用提升的权限打开命令提示符窗口 (以 管理员身份) 运行 ,然后导航到包含 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 组件的信息。
在测试计算机上打开命令提示符窗口。
运行
%WDTFDir%\Tools\CheckWDTFInstall.cmd
。打开日志文件 CheckWDTFInstall.log 并检查结果。
如何卸载 WDTF 运行时库
设置用于部署的测试计算机时,按照 为驱动程序部署和测试设置计算机的说明 (WDK 10) ,WDTF 运行时库安装在目标计算机上。
可以通过从目标计算机中删除预配来删除 WDTF 运行时库。 有关详细信息,请参阅 从目标计算机中删除预配。
还可以手动卸载 WDTF 运行时库。
在测试计算机上手动卸载 WDTF
在测试计算机上,转到 “设置” ,然后选择“ 应用”。
在 “程序和功能”中,找到“Windows 驱动程序测试框架 (WDTF) 运行时库”,选择并按住 (或右键单击“) ”,然后选择“ 卸载”。