Como faço para enviar mensagens de rastreamento para um depurador do kernel?

Você pode usar vários métodos para redirecionar mensagens de rastreamento para um depurador de modo kernel. Alguns são discutidos aqui.

Você pode redirecionar mensagens de rastreamento para o KD ou para o Windbg, o que estiver anexado. O depurador deve ser conectado através de uma porta COM com um cabo de depuração (modem nulo) ou através da porta 1394 ("firewire") com um cabo IEEE 1394. Não é possível redirecionar mensagens de rastreamento para outros depuradores do kernel, como o NTSD.

Para exibir mensagens de rastreamento em um depurador, wmitrace.dll e traceprt.dll devem estar no caminho de pesquisa do depurador no computador host. Essas DLLs estão incluídas no Ferramentas de Depuração para Windows Além disso, para permitir que o depurador localize os arquivos de formato de mensagem de rastreamento (.tmf) para as mensagens de rastreamento, os arquivos TMF devem estar no caminho de pesquisa do depurador no computador host. Para definir o caminho de pesquisa do depurador, use a extensão do depurador especializado !wmitrace.searchpath ou defina o valor da variável de ambiente %TRACE_FORMAT_SEARCH_PATH%.

Para obter mais informações, procure !wmitrace em Ferramentas de Depuração para Windows.

Logman

Use o seguinte comando do Logman para redirecionar mensagens de rastreamento para um depurador de modo kernel:

logman start TraceSession -ets -mode KernelFilter -bs 3

O parâmetro -ets inicia uma sessão de rastreamento de eventos que não está sob o controlo do serviço Performance Logs e Alertas. O parâmetro -mode ativa opções avançadas, incluindo a opção KernelFilter.

O parâmetro -bs define o tamanho do buffer para a sessão de rastreamento como 3 KB, o tamanho máximo do buffer para o depurador. Se você omitir esse parâmetro, a sessão do depurador não funcionará corretamente.

O Logman está incluído no Windows XP e em versões posteriores do Windows.

Tracelog

Para redirecionar mensagens de rastreamento para um depurador de modo kernel, utilize o seguinte comando Tracelog:

tracelog -start MyTrace -guid MyProvider.ctl -rt -kd

O parâmetro -guid especifica o provedor de rastreamento . O parâmetro -rt especifica uma sessão de rastreamento em tempo real. O parâmetro -kd redireciona as mensagens de rastreamento para o depurador do kernel e define o tamanho máximo do buffer para 3 KB, o máximo para o depurador.

Para obter um exemplo, consulte Exemplo 16: Exibindo mensagens de rastreamento em um depurador.

O Tracelog está localizado no subdiretório tools\tracing\<Platform> do WDK, onde <Platform> é i386, amd64 ou ia64.

TraceView

TraceView tem uma interface gráfica do usuário.

Você pode redirecionar mensagens de rastreamento para um depurador do kernel ao criar uma sessão de rastreamento. Na página Opções de Sessão de Log, clique em Opções Avançadas de Sessão de Log, clique na guia Opções de Parâmetro de Sessão de Log e altere o valor da opção Windbg para TRUE. Não é possível alterar essa opção enquanto a sessão de rastreamento estiver em execução.

O TraceView está localizado no subdiretório tools\tracing\<Platform> do WDK, onde <Platform> é i386, amd64 ou ia64.