Exemplo 5: Formatação Real-Time sessões de rastreamento

Você pode usar Tracefmt para formatar mensagens de rastreamento de sessões de rastreamento em tempo real, além de arquivos de log de rastreamento.

A sequência de comandos a seguir usa Tracelog e Tracefmt. O primeiro comando usa Tracelog para iniciar uma sessão de rastreamento em tempo real com o provedor de rastreamento de exemplo Tracedrv. TraceDrv, um driver de exemplo que foi projetado para rastreamento de software, está disponível no repositório de exemplos de driver do Windows no GitHub.

tracelog -start MyTrace -guid tracedrv.ctl -flag 1 -rt

Esse comando inicia uma sessão de rastreamento chamada MyTrace. Ele usa o parâmetro -guid para identificar o provedor de rastreamento, Tracedrv.sys, usando seu arquivo GUID de controle, tracedrv.ctl. Ele usa o parâmetro -flag para definir o valor do sinalizador de rastreamento como 1. Ele usa o parâmetro -rt para iniciar uma sessão de rastreamento que entrega mensagens diretamente a um consumidor de rastreamento, como Tracefmt. Sem o parâmetro -rt , o provedor de rastreamento enviaria mensagens apenas para um arquivo de log.

O próximo comando usa Tracefmt para formatar as mensagens geradas pelo Tracedrv durante a sessão de rastreamento MyTrace.

tracefmt -rt MyTrace -p c:\tracing -o mytrace.txt

Esse comando Tracefmt usa o parâmetro -rt para identificar a sessão de rastreamento em tempo real, MyTrace e o parâmetro -p para especificar o diretório no qual o arquivo TMF para Tracedrv.sys está localizado. O parâmetro -o direciona a saída para o arquivo mytrace.txt no diretório local.

Em resposta a esse comando, Tracefmt se prepara para formatar as mensagens de rastreamento em tempo real. Ele exibe as seguintes mensagens status, mas não retorna ao prompt de comando:

c:\tracetools>tracefmt -rt mytrace -display -o mytrace.txt
Setting RealTime mode for  mytrace
Getting guids from c:\tracetools\default.tmf

O comando Tracelog a seguir interrompe a sessão de rastreamento MyTrace. Você deve digitar o comando em uma janela diferente do Prompt de Comando.

tracelog -stop mytrace

Quando a sessão de rastreamento é interrompida, Tracefmt relata que escreveu as mensagens de rastreamento no arquivo de saída e retorna ao prompt de comando.

Event traces dumped to mytrace.txt
Event Summary dumped to mytrace.txt.sum