Extensões do NDIS (Ndiskd.dll)

  • Artigo

Esta seção descreve os comandos disponíveis no !ndiskd, uma extensão do depurador que é útil para depurar drivers NDIS (Especificação da Interface do Dispositivo de Rede). Esses comandos permitem que os desenvolvedores de driver de rede vejam uma visão maior da pilha de rede do Windows e como seus drivers interagem com ela. Com o !ndiskd, você pode ver o estado de todos os adaptadores de rede (!ndiskd.netadapter), um diagrama visual da pilha de rede do computador (!ndiskd.netreport), um log de tráfego nos adaptadores de rede(!ndiskd.nbllog) ou uma lista de todas as solicitações OID pendentes (!ndiskd.oid).

Os comandos podem ser encontrados em Ndiskd.dll. Para carregar os símbolos, insira .reload /f ndis.sys na janela de comando do depurador. Para confirmar os símbolos carregados com êxito, use a extensão !lmi ndis e procure a frase "Símbolos carregados com êxito" em direção à parte inferior. Seu resultado deve ser semelhante ao seguinte exemplo:

0: kd> !lmi ndis
Loaded Module Info: [ndis] 
         Module: ndis
   Base Address: fffff80174570000
     Image Name: ndis.sys
   Machine Type: 34404 (X64)
     Time Stamp: 938f9f4e (This is a reproducible build file hash, not a true timestamp)
           Size: 16f000
       CheckSum: 167a05
Characteristics: 22  
Debug Data Dirs: Type  Size     VA  Pointer
             CODEVIEW    21, d4060,   d2c60 RSDS - GUID: {9CC82DBE-96A0-773D-29E0-62B698C4C3A8}
               Age: 1, Pdb: ndis.pdb
                 POGO   988, d4084,   d2c84 [Data not mapped]
                REPRO    24, d4a0c,   d360c Reproducible build[Data not mapped]
     Image Type: MEMORY   - Image read successfully from loaded memory.
    Symbol Type: PDB      - Symbols loaded successfully from symbol server.
                 C:\ProgramData\Dbg\sym\ndis.pdb\9CC82DBE96A0773D29E062B698C4C3A81\ndis.pdb
    Load Report: public symbols , not source indexed 
                 C:\ProgramData\Dbg\sym\ndis.pdb\9CC82DBE96A0773D29E062B698C4C3A81\ndis.pdb

Muitos dos comandos de extensão no !ndiskd apresentam hiperlinks nos resultados exibidos na janela do depurador. O texto desses hiperlinks foi deixado nos exemplos fornecidos para ilustrar o formato exato do que você verá ao executar o comando em seu computador de depuração. Alguns dos exemplos também se referem explicitamente a clicar nesses links para que você possa entender os fluxos de uso típicos, embora os exemplos também forneçam as formas de linha de comando alternativas de cada comando.

Parâmetros comuns

Todos os comandos !ndiskd dão suporte aos seguintes parâmetros genéricos.

-Verbose
Mostra detalhes adicionais.

-Concisa
Suprime alguma saída clichê.

-Estático
Suprime alguma saída interativa.

-dml 0|1
Controla se a saída DML (linguagem de marcação do depurador) está habilitada.

-unicode 0|1
Controla se a saída de caractere Unicode é permitida.

-indent N
Usa N espaços por nível de recuo.

-Força
Substitui algumas verificações de segurança na integridade de dados remotos.

-Tracedata
Mostra mensagens de rastreamento detalhadas para depurar o próprio !ndiskd.

Adaptador de rede, driver NDIS e comandos gerais

Os comandos a seguir exibem informações sobre adaptadores de rede, drivers de rede e comandos gerais do computador associados à pilha de rede (como rcvqueues, opens, filters, OIDs e bloqueios RW).

Comandos NET_BUFFER_LIST e NET_BUFFER

Os comandos a seguir exibem informações relacionadas a estruturas de NET_BUFFER_LIST e NET_BUFFER .

Comandos NetAdapterCx

Os comandos a seguir exibem informações relacionadas à extensão de classe do WDF do adaptador de rede NetAdapterCx e suas estruturas associadas, NET_RING_BUFFER e NET_PACKET.

Comandos de adaptador de rede

Os comandos a seguir exibem informações relacionadas a adaptadores de rede.

Comandos NDIS_PACKET

Os comandos a seguir exibem informações sobre estruturas de NDIS_PACKET . Essas extensões são para drivers NDIS 5.x herdados. A estrutura NDIS_PACKET e sua arquitetura associada foram preteridas.

Comandos coNDIS

Os comandos a seguir exibem informações sobre conexões NDIS orientadas a conexões.

Comandos de depuração do NDIS

Os comandos a seguir exibem informações relacionadas a refcounts de NDIS, logs de eventos, rastreamentos de pilha e rastreamentos de depuração.

Comandos WDI

Os comandos a seguir exibem informações sobre drivers de miniporto WDI.

Comandos de informações NDIS e !ndiskd

Os comandos a seguir exibem informações sobre NDIS.sys e ndiskd.dll.

Comandos diversos

Para obter mais informações sobre como projetar drivers NDIS para o Windows Vista e posteriores, consulte o Guia de Design do Driver de Rede.

Para obter mais informações sobre a referência para drivers NDIS para Windows Vista e posteriores, consulte Referência de rede posterior e do Windows Vista.

Para obter uma demonstração do uso dos comandos do depurador !ndiskd para depurar a pilha de rede, consulte o vídeo Depurando o canal 9 da Pilha de Rede.