啟用和檢視 WDTF 追蹤
WDTF 追蹤 是指報告 WDTF 物件內部發生的事件。 由於 WDTF 經過大量檢測,因此所有 WDTF 物件都會在執行時提供追蹤資訊。 WDTF 會使用 WPP 軟體追蹤來處理追蹤。 這種類型的追蹤是一種標準化格式,您可以使用 WDK 工具來讀取,包括 TraceView。 本主題涵蓋如何使用 Logman 和 Tracefmt 來檢視 WDTF 執行時間追蹤。 本主題也會討論如何以程式設計方式設定 WDTF 追蹤層級。
如何收集及儲存 WDTF 追蹤
開始收集 WDTF 追蹤
在測試電腦上,以較高的許可權開啟命令提示字元視窗, (以 系統管理員 身分執行) ,然後輸入下列命令:
logman.exe 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
重新啟動電腦。
如需其他選項的相關資訊,請參閱 Logman (Logman.exe) 。 如需建立追蹤季的相關資訊,請參閱 設定和啟動自動記錄器會話。
停止收集 WDTF 追蹤並儲存記錄檔
您可以使用下列命令停止收集 WDTF 追蹤並刪除資料收集器:
logman.exe -stop -ets WDTF logman.exe delete "autosession\WDTF"
重新啟動電腦。
將記錄檔從測試電腦複製到另一部電腦,以供稍後分析。
收集的 ETL 記錄檔大小可能非常大。 為了獲得最佳結果,請將記錄檔從測試電腦 (例如 c:\WDTF_Traces\TraceFile.etl) 複製到另一部電腦。 然後,您可以從測試電腦刪除記錄檔。
如何檢視 WDTF 追蹤
檢視 WDTF 追蹤需要格式化 ETL 檔案。 下列步驟示範如何使用 Tracefmt.exe 將 ETL 檔案轉換成文字或 CSV 檔案。
檢視 WDTF 追蹤
例如,下列命令會將已儲存為 c:\WDTF_Traces\TraceFile.etl 的 ETL 檔案轉換成文字。
Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -o OutputTxtFile.txt
下列命令會將儲存為 c:\WDTF_Traces\TraceFile.etl 的 ETL 檔案轉換成逗號分隔的檔案 (CSV) 。
Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -csv –o OutputCsvFile.csv
在 Microsoft Excel 中開啟 CSV 檔案,讓您可以使用 Excel 的篩選功能來篩選收集的追蹤。 您可以篩選特定時段的追蹤。 您可以篩選追蹤,以檢查特定 WDTF 元件所記錄的追蹤。
以程式設計方式設定 WDTF 追蹤層級
所有 WDTF 物件都會在執行時提供追蹤資訊。
WDTF 提供一組可設定 的 TTraceLevel 層級。 如需如何在執行時間設定特定物件實例 TTraceLevel 的資訊,請參閱 ITracing::SetTraceLevel 方法。
如需如何為介面設定預設 TTraceLevel 的資訊,請參閱 Windows 裝置測試架構參考。
如需每個 TTraceLevel中包含的追蹤類型詳細描述,請參閱 ITracer 介面。 您可以使用 ITracer的登錄 TraceLevel 路徑,全域設定這些層級。
下表描述您可以設定的追蹤層級。
層級 | 描述 |
---|---|
0 | 關閉。 未提供追蹤。 |
1 | 低 |
2 | 中。 此層級是追蹤的預設層級。 |
3 | 高 |
4 | 完整。 會報告所有追蹤資訊。 |
5-8 | 自訂層級。 |
9 | 將 物件設定回其初始追蹤層級。 |
當您使用追蹤內容進行偵錯時,請考慮將所有物件的追蹤層級設定為 1,然後針對您要檢查的物件設定追蹤層級更高。
如需追蹤層級的詳細資訊,請參閱 ITracer 介面。