Partilhar via

Extensões NDIS (Ndiskd.dll)

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 drivers de rede vejam uma imagem maior da pilha de rede do Windows e como seus drivers interagem com ela. Com !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, digite .reload /f ndis.sys na janela de comando do depurador. Para confirmar os símbolos carregados com sucesso, use a extensão !lmi ndis e procure a frase "Símbolos carregados com sucesso" na parte inferior. O resultado deverá ter um aspeto 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 que eles exibem na janela do depurador. O texto para esses hiperlinks foi deixado nos exemplos fornecidos para ilustrar o formato exato do que você verá quando executar o comando em sua máquina 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 suportam os seguintes parâmetros genéricos.

-verborrágico
Mostra detalhes adicionais.

-sucinto
Suprime algumas saídas clichês.

-estática
Suprime alguma saída interativa.

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

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

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

-força
Substitui algumas verificações de segurança sobre a sanidade remota dos dados.

-dados de rastreio
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 da máquina associados à pilha de rede (como rcvqueues, opens, filters, OIDs e RW locks).

NET_BUFFER_LIST e NET_BUFFER comandos

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

Comandos NetAdapterCx

Os comandos a seguir exibem informações relacionadas ao adaptador de rede WDF Class Extension NetAdapterCx e suas estruturas associadas, NET_RING_BUFFER e NET_PACKET.

Comandos da interface de rede

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

NDIS_PACKET Comandos

Os comandos a seguir exibem informações sobre NDIS_PACKET estruturas. 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 Connection-Oriented conexões NDIS .

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 miniporta WDI.

Comandos de informação 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 o Windows Vista e posterior, consulte o Network Driver Design Guide).

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

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

  • Last updated on