Partilhar via

Rastreamento de chamadas de driver WDF (WdfCallTracer)

  • Artigo

Você pode usar WdfCallTracer para rastrear e exibir a comunicação do driver com a estrutura em tempo real. WdfCallTracer é o nome de uma funcionalidade e não um arquivo executável separado (não há binário separado para isso.).

Usando essa funcionalidade, você pode exibir a DDI e as chamadas de evento em tempo real.

O procedimento a seguir mostra como configurar o WdfTester usando a comunicação do driver para o Exemplo de Driver de Barramento Estático KMDF (Statbus.sys disponível no WDK). Atualmente, somente as chamadas DDI podem ser exibidas.

Para configurar o Rastreamento de Chamadas de Driver do WDF e compilar o driver de exemplo

  1. Instale a instalação do WdfTester.

  2. Crie o exemplo de driver de barramento estático KMDF (Statbus.sys). O exemplo kmdf está localizado no diretório %WDKRoot%\src\general\toaster\toastDrv\kmdf\bus\static.

  3. Copie o exemplo de driver de barramento para o diretório que contém os arquivos WdfTester que você instalou. Carregue o driver seguindo as instruções para os exemplos da Torradeira KMDF. Use o DevCon (Devcon.exe) ou o Assistente para Adicionar Novo Hardware.

Use o procedimento a seguir para configurar o TraceView para que você possa exibir a DDI e as chamadas de evento em tempo real

Para criar uma nova sessão de log no TraceView

  1. Inicie TraceView.exe (%WDKRoot%\tools\<platform>).

  2. No menu Arquivo , clique em Criar Nova Sessão de Log.

  3. Na caixa de diálogo Criar Sessão de Log , clique em Adicionar Provedor.

  4. Na caixa de diálogo Configuração do GUID de Controle do Provedor, clique em Arquivo CTL (GUID de Controle).

  5. Clique no botão Procurar e selecione arquivo Wdftester.ctl no diretório que contém arquivos WdfTester e seu driver.

  6. Clique em OK.

  7. Na caixa de diálogo Formatar Fonte de Informações Selecione , clique em Selecionar Arquivos TMF e clique em OK.

  8. Na caixa de diálogo Configuração de Informações de Formato de Rastreamento , clique em Adicionar e navegue até o diretório em que os arquivos WdfTester estão localizados.

  9. Clique em Wdftester.tmf, clique em Abrir para selecionar o arquivo e clique em Concluído.

  10. Clique em Avançar na caixa de diálogo Criar Sessão de Log e clique em Concluir.

Agora você está pronto para registrar o driver e habilitar o rastreamento para que possa exibir a comunicação do driver.

Para registrar o driver KMDF e habilitar o rastreamento

  1. Abra uma janela do Prompt de Comando e altere para o diretório em que você instalou os arquivos Wdftester.

  2. Registre o driver KMDF (neste exemplo, Statbus.sys) usando o script WdftesterScript.wsf.

    cscript WdftesterScript.wsf register statbus.sys

  3. Habilite o driver de Gerenciador de Dispositivos ou conecte seu hardware. Se o driver já estiver habilitado, use Gerenciador de Dispositivos para desabilitá-lo e habilite-o novamente.

Agora você deve ver a comunicação do driver no aplicativo TraceView.