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(首选方法)
安装 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 命令的选项。
| 选项 | 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 组件的信息。
在测试计算机上打开命令提示符窗口。
运行
%WDTFDir%\Tools\CheckWDTFInstall.cmd。打开日志文件CheckWDTFInstall.log并检查结果。
如何卸载 WDTF 运行时库
为部署设置测试计算机时,按照说明 为驱动程序部署和测试(WDK 10)预配计算机时,WDTF 运行时库安装在目标计算机上。
可以通过在目标计算机上取消配置来删除 WDTF 运行时库。 有关详细信息,请参阅 从目标计算机中删除预配。
还可以手动卸载 WDTF 运行时库。
在测试计算机上手动卸载 WDTF
在测试计算机上,转到 “设置” ,然后选择“ 应用”。
在 “程序和功能”中,找到 Windows 驱动程序测试框架(WDTF)运行时库,选择并按住(或右键单击),然后选择“ 卸载”。