Fichier de message récapitulative

Un fichier de message récapitulatif est un fichier texte qui contient les informations relatives à une trace logicielle. Tracefmt crée un fichier de message de synthèse (.sum) après le traitement des messages dans un journal de trace ou une session de suivi.

Le fichier de message récapitulative inclut les données suivantes dans un résumé statistique :

• Nombre de mémoires tampons traitées

• Nombre de messages traités et perdus

• Temps écoulé, en microsecondes, de la session de suivi

Après le résumé statistique se trouve un tableau composé d’une ligne pour chaque message de trace représenté dans la trace. Chaque colonne de la table fournit les informations suivantes sur le message de trace :

EventCount
Nombre d’instances du message de trace dans la trace.

Eventname
Nom convivial du GUID de message des messages de trace. Par défaut, le nom convivial d’un GUID de message est le nom du répertoire dans lequel le fournisseur de trace a été créé, mais vous pouvez spécifier un autre nom convivial à l’aide du paramètre -p pour RUN_WPP ou Tracewpp.exe. Pour plus d’informations, consultez Options Run_WPP. (EventName a la même valeur que la variable %1 dans le préfixe de message de trace.)

Eventtype
Nom convivial du message de trace. Par défaut, le nom convivial d’un message de trace est le nom du fichier source et le numéro de ligne du code qui a généré le message de trace. (EventType a la même valeur que la variable %2 dans le préfixe de message de trace.)

GUID
GUID de message des messages de trace.

L’exemple suivant montre un fichier de message récapitulatif pour le journal de trace testtrace.etl généré par Tracedrv, un exemple de pilote instrumenté pour le suivi. TraceDrv, un exemple de pilote qui a été conçu pour le suivi logiciel, est disponible à partir du référentiel d’exemples de pilotes Windows sur GitHub.

Files Processed:
d:\DDK Tools\tracetools\testtrace.etl
Total Buffers Processed 4
Total Events  Processed 1718
Total Events  Lost      4
Elapsed Time            122 sec
+---------------------------------------------------------------------------------+
|EventCount    EventName    EventType         Guid                                |
+---------------------------------------------------------------------------------+
|         1    Header       Header            68fdd900-4a3e-11d1-84f4-0000f80464e3|
|      1700    tracedrv     tracedrv_c264     37753236-c81f-505e-d40a-128d3bb2b5ff|
|        17    tracedrv     tracedrv_c258     37753236-c81f-505e-d40a-128d3bb2b5ff|
+---------------------------------------------------------------------------------+

Le résumé précédent montre que Tracedrv génère un message d’en-tête et deux messages de suivi. Un message de trace est généré par une instruction DoTraceMessage à la ligne 264 et l’autre est généré par une instruction DoTraceMessage à la ligne 258. Dans ce journal de suivi, il existe 1700 instances du premier message de trace et 17 instances du deuxième message de trace.

Le fichier de message de synthèse est principalement utilisé pour déboguer le suivi logiciel, et son format est susceptible d’être modifié.