收集和查看 Windows 设备测试框架 (WDTF) 跟踪

项目
06/20/2023

Windows Hardware Lab Kit (Windows HLK) 中的大多数设备基础功能可靠性测试都是使用 Windows 设备测试框架 (WDTF) 编写而成。在排查设备基础功能测试失败问题时，收集和查看 WDTF 跟踪非常有用。

如何收集 WDTF 跟踪

要收集 WDTF 跟踪，必须执行以下步骤：

启动新的跟踪收集会话。
从命令行运行测试并重现失败。（请参阅通过从命令行运行测试来重现测试失败）
停止跟踪收集会话。

启动 WDTF 跟踪

可以从命令行启动 WDTF 跟踪集合，如以下过程所示。

从命令行启动 WDTF 跟踪

使用管理权限打开命令提示符。

键入以下命令：

logman create trace "autosession\WDTF" -p {6210f559-c7f7-4d2f-b674-4bc9315cecc7} 0xffffffff 0xff -o c:\WDTF_Traces\TraceFile.etl
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v LogFileMode /t REG_DWORD /d 1 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v FileMax /t REG_DWORD /d 16 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v MaxFileSize /t REG_DWORD /d 0 /f

重新启动计算机。

注意

有关跟踪选项的详细信息，请参阅配置和启动 AutoLogger 会话和 Logman。

停止收集跟踪

可以从命令行停止 WDTF 跟踪集合，如以下过程所示。

从命令行停止 WDTF 跟踪

使用管理权限打开命令提示符。

键入以下命令：

logman -stop -ets WDTF
logman delete "autosession\WDTF"

重新启动计算机。

删除收集的跟踪

收集的事件跟踪日志 (.etl) 文件可能非常大。建议将它们从测试系统复制到另一个系统供以后分析，然后从测试系统中删除它们。

如何查看 WDTF 跟踪

要查看 WDTF 跟踪，必须先将收集的 .etl 文件格式化为文本或逗号分隔的可变长度 (CSV) 版本。

可以从命令行运行 Tracefmt 以创建格式化日志文件：

从命令行创建格式化日志文件

使用管理权限打开命令提示符。
键入 Tracefmt.exe -r https://msdl.microsoft.com/download/symbols<ETL 文件的完整路径> -o OutputTxtFile.txt
键入 Tracefmt.exe -r https://msdl.microsoft.com/download/symbols<ETL 文件的完整路径> -csv -o OutputCsvFile.csv

可以在 Microsoft Excel 中打开 CSV 文件；可以使用 Excel 的筛选功能来筛选收集的跟踪，以及根据特定时间段、特定 WDTF 组件和其他特定条件搜索跟踪。

通过