Fonctionnement de Tracefmt

Les fournisseurs de trace enregistrent les messages de trace sous forme binaire par souci d’efficacité. Pour afficher les messages de trace sous forme lisible, Tracefmt applique les instructions de mise en forme de chaque message, puis les affiche ou les enregistre dans un fichier texte.

Les instructions de mise en forme des messages de trace sont incluses dans le code source des fournisseurs de trace qui utilisent le suivi logiciel WPP, puis sont compilées dans les versions privées ou complètes du fichier de symboles PDB pour le fournisseur de trace. Le préprocesseur WPP extrait les instructions de mise en forme des symboles privés et les place dans un fichier de format de message de trace (.tmf) pour le fournisseur.

Pour mettre en forme les messages de trace, Tracefmt nécessite un fichier TMF. Vous pouvez fournir le fichier TMF à Tracefmt ou diriger Tracefmt pour créer un fichier TMF pour vous. Utilisez l’une des méthodes suivantes pour fournir l’entrée requise.

Utiliser Default.tmf. Étant donné que la plupart des applications et des pilotes utilisent des formats de message standard, leurs messages peuvent être mis en forme à l’aide d’informations dans Default.tmf, un fichier inclus dans WDK.

Fournir un fichier TMF. Vous pouvez spécifier un fichier TMF spécifique en fournissant son chemin d’accès et son nom de fichier.

Indiquer le chemin d’accès à un répertoire de fichiers TMF. Tracefmt peut utiliser le message GUID des messages de trace pour identifier le fichier TMF qui contient des instructions de mise en forme pour le message dans un répertoire de fichiers TMF. Les noms de fichiers TMF se composent du GUID du message avec une extension de nom de fichier .tmf.

Diriger Tracefmt pour créer un fichier TMF. Tracefmt peut utiliser le fichier image (.exe, .dll ou .sys) pour le fournisseur de trace pour rechercher le fichier de symboles PDB privé pour le fournisseur de trace dans un répertoire ou à l’aide d’un serveur de symboles interne. Il crée ensuite un fichier TMF à partir des données du fichier PDB et utilise le fichier TMF pour mettre en forme les messages de trace. Lorsqu’il crée un fichier TMF, Tracepdb crée un fichier MOF (.mof) qui contient le GUID de contrôle et les niveaux de trace de chaque fournisseur de trace représentés dans le fichier PDB. Le nom du fichier MOF est le nom du module du fournisseur de trace.

Après avoir mis en forme les messages de trace, Tracefmt peut afficher les messages de trace sur la ligne de commande et créer les fichiers suivants :

• Un fichier de sortie des messages de trace mis en forme. Les messages apparaissent dans l’ordre dans lequel ils ont été générés par le fournisseur de trace. Chaque message est précédé d’un préfixe de trace. Pour en savoir plus, consultez Préfixe du message de trace.

• Un fichier de résumé des messages d’information sur la session de trace pendant laquelle les messages de trace ont été générés.

Pour en savoir plus sur le traçage d’événements, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows. Pour en savoir plus sur l’utilisation du suivi d’événements dans les pilotes, consultez Suivi logiciel WPP.