Noções básicas sobre o Tracefmt

Os provedores de rastreamento registram mensagens de rastreamento em formato binário por motivos de eficiência. Para exibir as mensagens de rastreamento em formato legível, o Tracefmt aplica as instruções de formatação de cada mensagem e, em seguida, exibe as mensagens ou as salva em um arquivo de texto.

Dica

O TraceView fornece a mesma funcionalidade que o Tracefmt com uma GUI mais fácil de usar.

As instruções de formatação de mensagens de rastreamento são incluídas no código-fonte de provedores de rastreamento que usam rastreamento de software WPP e, em seguida, são compiladas nas versões privadas ou completas do arquivo de símbolo PDB para o provedor de rastreamento. O pré-processador WPP extrai as instruções de formatação dos símbolos privados e as coloca em um arquivo de formato de mensagem de rastreamento (.tmf) para o provedor.

Para formatar as mensagens de rastreamento, o Tracefmt requer um arquivo TMF. Você pode fornecer o arquivo TMF para Tracefmt ou direcionar o Tracefmt para criar um arquivo TMF para você. Use qualquer um dos métodos a seguir para fornecer a entrada necessária.

Use Default.tmf. Como a maioria dos aplicativos e drivers usa formatos de mensagem padrão, suas mensagens podem ser formatadas usando informações em Default.tmf, um arquivo incluído no WDK.

Forneça um arquivo TMF. Você pode especificar um arquivo TMF específico fornecendo seu caminho e nome do arquivo.

Forneça o caminho para um diretório de arquivos TMF. O Tracefmt pode usar o GUID das mensagens de rastreamento para identificar o arquivo TMF que contém instruções de formatação da mensagem em um diretório de arquivos TMF. Os nomes de arquivo TMF consistem no GUID da mensagem com uma extensão de nome de arquivo .tmf.

Direcione o Tracefmt para criar um arquivo TMF. O Tracefmt pode usar o arquivo de imagem (.exe, .dll ou .sys) para que o provedor de rastreamento localize o arquivo de símbolo PDB privado do provedor de rastreamento em um diretório ou usando um servidor de símbolos interno. Em seguida, ele cria um arquivo TMF a partir dos dados no arquivo PDB e usa o arquivo TMF para formatar as mensagens de rastreamento. Quando cria um arquivo TMF, o Tracepdb cria um arquivo MOF (.mof) que contém o GUID de controle e os níveis de rastreamento de cada provedor de rastreamento representado no arquivo PDB. O nome do arquivo MOF é o nome do módulo do provedor de rastreamento.

Depois de formatar as mensagens de rastreamento, o Tracefmt pode exibir as mensagens de rastreamento na linha de comando e pode criar os seguintes arquivos:

• Um arquivo de saída de mensagens de rastreamento formatadas. As mensagens aparecem na ordem em que foram geradas pelo provedor de rastreamento. Cada mensagem é precedida por um prefixo de rastreamento. Para obter mais informações, consulte Prefixo da mensagem de rastreamento.

• Um arquivo de mensagem de resumo com informações sobre a sessão de rastreamento durante a qual as mensagens de rastreamento foram geradas.

Para obter mais informações sobre o rastreamento de eventos, consulte a documentação do SDK do Microsoft Windows. Para obter informações sobre como usar o rastreamento de eventos em drivers, consulte Rastreamento de software WPP.