Fichier de message récapitulatif

Un fichier de message récapitulative est un fichier texte qui contient les informations relatives à une trace logicielle. Tracefmt crée un fichier de message récapitulative (.sum) après avoir traité les messages dans un journal de suivi 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

Le résumé statistique suivant est une table composée 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 du message des messages de suivi. 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 Run_WPP Options. (EventName a la même valeur que la variable %1 dans le préfixe du 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 du message de trace.)

GUID
GUID du message des messages de suivi.

L’exemple suivant montre un fichier de message de synthèse 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 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 trace. Un message de trace est généré par une instruction DoTraceMessage sur la ligne 264 et l’autre est générée par une instruction DoTraceMessage sur la ligne 258. Dans ce journal de suivi, il existe 1700 instances du premier message de suivi et 17 instances du deuxième message de suivi.

Le fichier de message récapitulatif est principalement utilisé pour déboguer le traçage logiciel, et son format peut changer.