Fichier de format de message de suivi

  • Article

Le fichier TMF ( Trace Message Format ) est un fichier texte structuré qui contient des instructions pour l’analyse et la mise en forme des messages de suivi binaires générés par un fournisseur de trace . Les instructions de mise en forme sont incluses dans le code source du fournisseur de trace et sont ajoutées au fichier de symboles PDB du fournisseur de trace par le préprocesseur WPP.

Certains outils qui journalisent et affichent des messages de suivi mis en forme nécessitent un fichier TMF. Tracefmt et TraceView, outils WDK qui mettent en forme et affichent des messages de suivi, peuvent utiliser un fichier TMF ou extraire les informations de mise en forme directement à partir d’un fichier de symboles PDB.

Vous pouvez créer un fichier TMF à l’aide de Tracefmt et en incluant le paramètre -i , qui indique à Tracefmt de créer un fichier TMF pour Tracedrv. Pour plus d’informations, consultez Exemple 9 : Création d’un fichier TMF.

Si vous n’avez pas de fichier TMF pour un fournisseur de trace, utilisez Tracepdb. Tracepdb extrait les instructions de mise en forme du fichier de symboles PDB et crée un fichier TMF pour les stocker. De nombreux développeurs d’applications et de pilotes préfèrent envoyer un fichier TMF plutôt qu’un fichier de symboleS PDB.

Le nom du fichier TMF est le GUID de message des messages associés à ce fichier TMF. ETW utilise le GUID de message pour associer des messages de trace particuliers au fichier TMF contenant leurs instructions de mise en forme.

Un fichier TMF contient les données suivantes :

  • Nom du fichier PDB à partir duquel les données du fichier TMF ont été extraites.

  • GUID de message des messages de trace dans le fichier source et nom du fichier source.

  • Pour chaque message de trace, une entrée qui spécifie le type de message, le nom du fichier de code source, un numéro de ligne, un numéro de message, une chaîne de définition de message, un nom d’indicateur de trace et le nom de la fonction C qui contient l’appel de macro.

  • Liste de variables dont les valeurs apparaissent dans les messages de suivi et les noms de types internes associés. Les variables sont représentées par la notation %n dans une chaîne de définition de message.

Note Le fichier TMF est réservé à un usage interne et son format est susceptible de changer entre les différentes versions de Windows.