Rubrikfil för spårningsmeddelande

En TMH-fil ( trace message header ) är en textfil som innehåller deklarationer av funktioner och variabler som används av spårningskoden som WPP genererar. Rubrikfilen innehåller även makron som lägger till formateringsinstruktioner för spårningsmeddelanden i en PDB-fil för en spårningsprovider, till exempel en drivrutin i kernelläge eller ett program i användarläge.

WPP genererar TMH-filen automatiskt när du kompilerar en spårningsprovider som innehåller WPP-makron. TMH-filen har samma namn som källfilen, men med filnamnstillägget .tmh. WPP sparar filen i samma katalog som källfilen.

När du lägger till WPP-makron i källkoden måste du också lägga till ett #include-direktiv för TMH-filen som WPP genererar. Inkludera-instruktionen har formatet:

#include SourceFileName.tmh

Den här include-instruktionen måste visas efter definitionen av WPP_CONTROL_GUIDS-makrot, men innan några anrop till WPP-makrona.

Mer information finns i Lägga till WPP-makron till en spårningsproducent och se TraceDrv, en exempeldrivrutin som har utformats för spårning av programvara. TraceDrv-exemplet är tillgängligt i windows-drivrutinsprovlagringsplatsen på GitHub.