Berichtkopbestand traceren

Een TMH-bestand ( Trace Message Header ) is een tekstbestand dat declaraties bevat van functies en variabelen die worden gebruikt door de traceringscode die WPP genereert. Het headerbestand bevat ook macro's waarmee instructies voor traceringsberichtopmaak worden toegevoegd aan een PDB-bestand van een traceringsprovider, zoals een stuurprogramma voor kernelmodus of toepassing in de gebruikersmodus.

WPP genereert het TMH-bestand automatisch wanneer u een traceringsprovider compileert die WPP-macro's bevat. Het TMH-bestand heeft dezelfde naam als het bronbestand, maar met de extensie .tmh. WPP slaat het bestand op in dezelfde map als het bronbestand.

Wanneer u de WPP-macro's toevoegt aan broncode, moet u ook een #include instructie toevoegen voor het TMH-bestand dat door WPP wordt gegenereerd. De include-instructie heeft de vorm:

#include SourceFileName.tmh

Deze include-instructie moet voorkomen na de definitie van de WPP_CONTROL_GUIDS macro, maar voordat aanroepen van de WPP-macro's worden uitgevoerd.

Zie WPP-macro's toevoegen aan een traceringsproducent en TraceDrv, een voorbeeldstuurprogramma dat is ontworpen voor softwaretracering, voor meer informatie. Het TraceDrv-voorbeeld is beschikbaar in de opslagplaats met Windows-stuurprogrammavoorbeelden op GitHub.