Vue d’ensemble de Tracepdb

Les fournisseurs de trace, tels que les applications en mode utilisateur et les pilotes en mode noyau, stockent leurs messages de trace sous forme binaire pour plus d’efficacité. Pour lire les messages de suivi, vous devez appliquer les instructions de mise en forme spécifiées pour chaque message de trace dans le code du fournisseur de trace.

Le préprocesseur WPP extrait les instructions de mise en forme du code du fournisseur de trace et les ajoute aux fichiers de symboles PDB pour le fournisseur de trace.

Tracepdb extrait les instructions de mise en forme des versions complètes ou privées du fichier de symboles PDB pour un fournisseur de trace (les instructions de mise en forme de trace sont supprimées des fichiers de symboles publics.) et crée des fichiers de format de message de suivi (.tmf) pour chaque fournisseur de trace dans le code source. Les fichiers TMF sont des fichiers texte qui contiennent uniquement les instructions de mise en forme des messages de trace du fournisseur.

Les outils qui affichent des messages de suivi au format lisible, tels que TraceView et Tracefmt, utilisent des fichiers TMF pour analyser et mettre en forme les messages de suivi. En outre, vous pouvez distribuer des fichiers TMF aux utilisateurs au lieu de distribuer des fichiers de symboles privés.

Tracepdb crée un fichier MOF (.mof) qui contient le GUID de contrôle et les niveaux de trace de chaque fournisseur de trace qui sont représentés dans le fichier PDB. Le nom du fichier MOF est le nom du module du fournisseur de trace.

Tracepdb peut également créer un fichier de contrôle de message de suivi (.tmc) pour chaque fournisseur de trace dans le code source si vous utilisez l’option -c . Le fichier TMC contient le GUID de contrôle et les niveaux de trace de chaque fournisseur de trace représenté dans le fichier PDB. Le nom du fichier TMC est le GUID de contrôle du fournisseur de trace. Vous ne devez vous soucier du fichier TMC que si vous utilisez Traceview sans fichier PDB.

La seule fonction de Tracepdb est de créer des fichiers TMF. Toutefois, d’autres outils, tels que BinPlace, TraceView et Tracefmt, créent des fichiers TMF, en plus de leurs autres fonctionnalités. L’utilisation de Tracepdb équivaut à utiliser la commande binplace -:tmf , la commande traceview -parsepdb et la commande tracefmt -i .

Sur les systèmes antérieurs à Windows Vista, Tracepdb nécessite mspdb70.dll et msvcr70.dll. Si ces fichiers ne se trouvent pas dans le même répertoire que le fichier Tracepdb.exe, déplacez-les avant d’utiliser Tracepdb.

Sur les systèmes antérieurs à Windows Vista, vous devez copier le fichier Dbghelp.dll à partir du sous-répertoire bin\<Platform> du Kit de pilotes Windows (WDK) (où <Platform>est x86, amd64 ou ia64) dans le répertoire dans lequel se trouve Tracefmt.exe.

Pour plus d’informations sur le suivi des événements, consultez la documentation du Kit de développement logiciel (SDK) Windows. Pour plus d’informations sur l’utilisation du suivi d’événements dans les pilotes en mode noyau et les applications en mode utilisateur, consultez Suivi logiciel WPP.