Extensões NDIS (Ndiskd.dll)

  • Artigo

Esta seção descreve os comandos disponíveis em !ndiskd, uma extensão do depurador que é útil para depurar drivers NDIS (Network Device Interface Specification). Esses comandos permitem que os desenvolvedores de driver de rede tenham uma visão geral 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 se os símbolos foram carregados com êxito, use a extensão !lmi ndis e procure a frase "Símbolos carregados com êxito" na 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 em !ndiskd apresentam hiperlinks nos resultados exibidos na janela do depurador. O texto para esses 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 alternativas de linha de comando de cada comando.

Parâmetros comuns

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

-prolixo
Mostra detalhes adicionais.

-conciso
Suprime algumas saídas clichês.

-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 caracteres Unicode é permitida.

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

-força
Substitui algumas verificações de segurança na sanidade 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 os adaptadores de rede, drivers de rede e comandos gerais do computador associados à pilha de rede (como rcvqueues, aberturas, filtros, OIDs e bloqueios RW).

NET_BUFFER_LIST e NET_BUFFER comandos

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

Comandos NetAdapterCx

Os comandos a seguir exibem informações relacionadas à Extensão de Classe WDF do Adaptador de Rede NetAdapterCx e suas estruturas associadas, NET_RING_BUFFER e NET_PACKET.

Comandos de interface de rede

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

NDIS_PACKET comandos

Os comandos a seguir exibem informações sobre estruturas 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 à conexão.

Comandos de depuração NDIS

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

Comandos WDI

Os comandos a seguir exibem informações sobre drivers de miniporte 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 criar drivers NDIS para Windows Vista e posteriores, consulte o Guia de Design de Driver de Rede.

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

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.