Compartilhar via


Visão geral do Tracepdb

Provedores de rastreamento, como aplicativos de modo de usuário e drivers de modo kernel, armazenam suas mensagens de rastreamento em formato binário para obter eficiência. Para ler as mensagens de rastreamento, você precisa aplicar as instruções de formatação especificadas para cada mensagem de rastreamento no código do provedor de rastreamento.

O pré-processador WPP extrai as instruções de formatação do código do provedor de rastreamento e as adiciona aos arquivos de símbolo PDB para o provedor de rastreamento.

O Tracepdb extrai as instruções de formatação das versões completas ou privadas do arquivo de símbolo PDB para um provedor de rastreamento (as instruções de formatação de rastreamento são removidas dos arquivos de símbolo público.) e cria arquivos de formato de mensagem de rastreamento (.tmf) para cada provedor de rastreamento no código-fonte. Arquivos TMF são arquivos de texto que contêm apenas as instruções de formatação para as mensagens de rastreamento do provedor.

Ferramentas que exibem mensagens de rastreamento em formato legível, como TraceView e Tracefmt, usam arquivos TMF para analisar e formatar mensagens de rastreamento. Além disso, você pode distribuir arquivos TMF aos usuários, em vez de distribuir arquivos de símbolo privados.

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 representados no arquivo PDB. O nome do arquivo MOF é o nome do módulo do provedor de rastreamento.

O Tracepdb também pode criar um arquivo de controle de mensagem de rastreamento (.tmc) para cada provedor de rastreamento no código-fonte se você usar a opção -c. O arquivo TMC 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 TMC é o GUID de controle do provedor de rastreamento. Você só deve se preocupar com o arquivo TMC se estiver usando o Traceview sem um arquivo PDB.

A única função do Tracepdb é criar arquivos TMF. No entanto, outras ferramentas, como BinPlace, TraceView e Tracefmt, criam arquivos TMF, além de outros recursos. O uso do Tracepdb é equivalente a usar o comando binplace -:tmf , o comando traceview -parsepdb e o comando tracefmt -i .

Em sistemas anteriores ao Windows Vista, o Tracepdb requer mspdb70.dll e msvcr70.dll. Se esses arquivos não estiverem no mesmo diretório que o arquivo Tracepdb.exe, mova-os antes de usar o Tracepdb.

Em sistemas anteriores ao Windows Vista, você deve copiar o arquivo Dbghelp.dll do subdiretório bin\<Platform> do WDK (Windows Driver Kit) (em < que Platform>é x86, amd64 ou ia64) para o diretório no qual Tracefmt.exe está localizado.

Para obter mais informações sobre o rastreamento de eventos, consulte a documentação do SDK do Windows. Para obter informações sobre como usar o rastreamento de eventos em drivers no modo kernel e aplicativos no modo usuário, consulte Rastreamento de software WPP.