追蹤訊息標頭 (TMH) 檔案是文字檔,其中包含 WPP 產生的追蹤程式碼所使用的函式和變數宣告。 標頭檔也包含宏,可將追蹤訊息格式化指示新增至 追蹤提供者的 PDB 檔案,例如核心模式驅動程式或使用者模式應用程式。
當您編譯包含 WPP 宏的 追蹤提供者 時,WPP 會自動產生 TMH 檔案。 TMH 檔案與來源檔案具有相同的名稱,但副檔名為 .tmh。 WPP 會將檔案儲存在與來源檔案相同的目錄中。
當您將 WPP 宏新增至原始程式碼時,也必須為 WPP 將產生的 TMH 檔案新增 #include 指示詞。 include 陳述式的格式為:
#include SourceFileName.tmh
此包含陳述式必須出現在 WPP_CONTROL_GUIDS 巨集的定義之後,但在任何呼叫 WPP 巨集之前出現。
如需詳細資訊,請參閱 將 WPP 宏新增至追蹤產生者,也請參閱 TraceDrv,這是專為軟體追蹤設計的範例驅動程式。 TraceDrv 範例可在 GitHub 上的 Windows 驅動程式範例 存放庫中使用。