File di messaggio di riepilogo

Un file di messaggio di riepilogo è un file di testo che contiene le informazioni su una traccia software. Tracefmt crea un file di messaggio di riepilogo (con estensione sum) dopo l'elaborazione dei messaggi in un log di traccia o in una sessione di traccia.

Il file di messaggio di riepilogo include i dati seguenti in un riepilogo statistico:

• Numero di buffer elaborati

• Numero di messaggi elaborati e persi

• Tempo trascorso, in microsecondi, della sessione di traccia

Il riepilogo statistico è costituito da una tabella composta da una riga per ogni messaggio di traccia rappresentato nella traccia. Ogni colonna della tabella fornisce le informazioni seguenti sul messaggio di traccia:

EventCount
Numero di istanze del messaggio di traccia nella traccia.

Eventname
Nome descrittivo del GUID del messaggio dei messaggi di traccia. Per impostazione predefinita, il nome descrittivo di un GUID del messaggio è il nome della directory in cui è stato compilato il provider di traccia, ma è possibile specificare un nome descrittivo alternativo usando il parametro -p per RUN_WPP o Tracewpp.exe. Per informazioni, vedere opzioni di Run_WPP. EventName ha lo stesso valore della variabile %1 nel prefisso del messaggio di traccia.

Eventtype
Nome descrittivo del messaggio di traccia. Per impostazione predefinita, il nome descrittivo di un messaggio di traccia è il nome del file di origine e il numero di riga del codice che ha generato il messaggio di traccia. EventType ha lo stesso valore della variabile %2 nel prefisso del messaggio di traccia.

GUID
GUID del messaggio dei messaggi di traccia.

Nell'esempio seguente viene illustrato un file di messaggio di riepilogo per il log di traccia testtrace.etl generato da Tracedrv, un driver di esempio instrumentato per la traccia. TraceDrv, un driver di esempio progettato per la traccia software, è disponibile nel repository degli esempi di driver di Windows in 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|
+---------------------------------------------------------------------------------+

Il riepilogo precedente mostra che Tracedrv genera un messaggio di intestazione e due messaggi di traccia. Un messaggio di traccia viene generato da un'istruzione DoTraceMessage alla riga 264 e l'altra viene generata da un'istruzione DoTraceMessage alla riga 258. In questo log di traccia sono presenti 1700 istanze del primo messaggio di traccia e 17 istanze del secondo messaggio di traccia.

Il file di messaggio di riepilogo viene usato principalmente per eseguire il debug della traccia software e il relativo formato è soggetto a modifiche.