File di intestazione del messaggio di traccia

Un file di intestazione del messaggio di traccia (TMH) è un file di testo che contiene dichiarazioni di funzioni e variabili usate dal codice di traccia generato da WPP. Il file di intestazione include anche macro che aggiungono istruzioni di formattazione dei messaggi di traccia a un file PDB di un provider di traccia, ad esempio un driver in modalità kernel o un'applicazione in modalità utente.

WPP genera automaticamente il file TMH quando si compila un provider di traccia che include macro WPP. Il file TMH ha lo stesso nome del file di origine, ma con estensione tmh. WPP salva il file nella stessa directory del file di origine.

Quando si aggiungono le macro WPP al codice sorgente, è necessario aggiungere anche una direttiva #include per il file TMH che verrà generato da WPP. L'istruzione include ha il formato seguente:

#include SourceFileName.tmh

Questa istruzione include deve essere visualizzata dopo la definizione della macro WPP_CONTROL_GUIDS , ma prima di tutte le chiamate alle macro WPP.

Per altre informazioni, vedere Aggiunta di macro WPP a un producer di traccia e vedere TraceDrv, un driver di esempio progettato per la traccia software. L'esempio TraceDrv è disponibile nel repository degli esempi di driver di Windows in GitHub.