Arquivo de mensagem de resumo

Um arquivo de mensagem de resumo é um arquivo de texto que contém as informações sobre um rastreamento de software. O Tracefmt cria um ficheiro de resumo de mensagens (.sum) depois de processar as mensagens num ficheiro de seguimento ou sessão de seguimento.

O ficheiro de mensagem de resumo inclui os seguintes dados numa síntese estatística:

• O número de buffers processados

• O número de mensagens processadas e perdidas

• O tempo decorrido, em microssegundos, da sessão de rastreio

A seguir ao resumo estatístico está uma tabela composta por uma linha para cada mensagem de rastreamento representada no rastreamento. Cada coluna da tabela fornece as seguintes informações sobre a mensagem de rastreamento:

EventCount
O número de instâncias da mensagem de rastreio no traço.

Nome do Evento
O nome amigável do GUID da mensagem das mensagens de rastreamento. Por padrão, o nome amigável de um GUID de mensagem é o nome do diretório no qual o provedor de rastreamento foi criado, mas você pode especificar um nome amigável alternativo usando o parâmetro -p para RUN_WPP ou Tracewpp.exe. Para obter informações, consulte Opções de Run_WPP. (EventName tem o mesmo valor que a variável %1 no prefixo da mensagem de rastreamento.)

Tipo de Evento
O nome amigável da mensagem de rastreamento. Por padrão, o nome amigável de uma mensagem de rastreamento é o nome do arquivo de origem e o número da linha do código que gerou a mensagem de rastreamento. (EventType tem o mesmo valor que a variável %2 no prefixo da mensagem de rastreamento.)

GUID
O GUID da mensagem das mensagens de rastreamento.

O exemplo a seguir mostra um ficheiro de mensagem sumária para o registo de rastreio testtrace.etl gerado por Tracedrv, um driver de exemplo instrumentado para rastreio. O TraceDrv, um driver de exemplo que foi projetado para rastreamento de software, está disponível no repositório de amostras de drivers do Windows no 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|
+---------------------------------------------------------------------------------+

O resumo anterior mostra que o Tracedrv gera uma mensagem de cabeçalho e duas mensagens de rastreamento. Uma mensagem de rastreamento é gerada por uma instrução DoTraceMessage na linha 264 e a outra é gerada por uma instrução DoTraceMessage na linha 258. Neste log de rastreamento, há 1700 instâncias da primeira mensagem de rastreamento e 17 instâncias da segunda mensagem de rastreamento.

O arquivo de mensagem de resumo é usado principalmente para depurar o rastreamento de software e seu formato está sujeito a alterações.