Arquivo de formato de mensagem de rastreamento

O arquivo TMF (formato de mensagem de rastreamento ) é um arquivo de texto estruturado que contém instruções para analisar e formatar as mensagens de rastreamento binárias geradas por um provedor de rastreamento . As instruções de formatação são incluídas no código-fonte do provedor de rastreamento e são adicionadas ao arquivo de símbolo PDB do provedor de rastreamento pelo pré-processador WPP.

Algumas ferramentas que registram e exibem mensagens de rastreamento formatadas exigem um arquivo TMF. Tracefmt e TraceView, ferramentas WDK que formatam e exibem mensagens de rastreamento, podem usar um arquivo TMF ou extrair as informações de formatação diretamente de um arquivo de símbolo PDB.

Você pode criar um arquivo TMF usando Tracefmt e incluindo o parâmetro -i , que direciona o Tracefmt para criar um arquivo TMF para Tracedrv. Para obter mais informações, consulte Exemplo 9: Criando um arquivo TMF.

Se não tiver um ficheiro TMF para um provedor de rastreamento, use Tracepdb. O Tracepdb extrai as instruções de formatação do arquivo de símbolos do PDB e cria um arquivo TMF para armazená-las. Muitos desenvolvedores de aplicativos e drivers preferem enviar um arquivo TMF, em vez de um arquivo de símbolo PDB.

O nome do arquivo TMF é o GUID da mensagem das mensagens associadas a esse arquivo TMF. ETW usa o GUID da mensagem para associar mensagens de rastreio específicas ao arquivo TMF que contém suas instruções de formatação.

Um arquivo TMF contém os seguintes dados:

• O nome do arquivo PDB do qual os dados do arquivo TMF foram extraídos.

• O GUID da mensagem das mensagens de rastreamento no arquivo de origem e o nome do arquivo de origem.

• Para cada mensagem de rastreamento, uma entrada que especifica o tipo de mensagem, o nome do arquivo do código-fonte, um número de linha, um número de mensagem, uma cadeia de caracteres de definição de mensagem, um nome de sinalizador de rastreamento e o nome da função C que contém a chamada de macro.

• Uma lista de variáveis cujos valores aparecem nas mensagens de rastreamento e seus nomes de tipo interno associados. As variáveis são representadas pela notação %n em uma cadeia de caracteres de definição de mensagem.

Observação O arquivo TMF é reservado para uso interno, e seu formato está sujeito a alterações entre diferentes versões do Windows.