Fichier d’en-tête de message de trace

Un fichier d’en-tête de message de trace (TMH) est un fichier texte qui contient des déclarations de fonctions et de variables utilisées par le code de suivi généré par WPP. Le fichier d’en-tête comprend également des macros qui ajoutent des instructions de mise en forme de message de trace à un fichier PDB d’un fournisseur de trace, tel qu’un pilote en mode noyau ou une application en mode utilisateur.

WPP génère automatiquement le fichier TMH lorsque vous compilez un fournisseur de trace qui inclut des macros WPP. Le fichier TMH porte le même nom que le fichier source, mais avec une extension de nom de fichier .tmh. WPP enregistre le fichier dans le même répertoire que le fichier source.

Lorsque vous ajoutez les macros WPP au code source, vous devez également ajouter une directive #include pour le fichier TMH que WPP va générer. L’instruction include se présente sous la forme suivante :

#include SourceFileName.tmh

Cette instruction include doit apparaître après la définition de la macro WPP_CONTROL_GUIDS , mais avant tout appel aux macros WPP.

Pour plus d’informations, consultez Ajout de macros WPP à un producteur de traces et TraceDrv, un exemple de pilote qui a été conçu pour le suivi logiciel. L’exemple TraceDrv est disponible dans le référentiel d’exemples de pilotes Windows sur GitHub.