Condividi tramite

Estensioni NDIS (Ndiskd.dll)

  • Articolo

Questa sezione descrive i comandi disponibili in !ndiskd, un'estensione del debugger utile per il debug dei driver NDIS (Network Device Interface Specification). Questi comandi consentono agli sviluppatori di driver di rete di visualizzare un quadro più generale dello stack di rete di Windows e del modo in cui i driver interagiscono con esso. Con !ndiskd è possibile visualizzare lo stato di tutte le schede di rete (!ndiskd.netadapter), un diagramma visivo dello stack di rete del computer (!ndiskd.netreport), un log del traffico sulle schede di rete(!ndiskd.nbllog) o un elenco di tutte le richieste OID in sospeso (!ndiskd.oid).

I comandi sono disponibili in Ndiskd.dll. Per caricare i simboli, immettere .reload /f ndis.sys nella finestra di comando del debugger. Per verificare che i simboli siano stati caricati correttamente, usare l'estensione !lmi ndis e cercare la frase "Simboli caricati correttamente" verso la parte inferiore. L'output dovrebbe essere simile all'esempio seguente:

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

Molti dei comandi di estensione in !ndiskd presentano collegamenti ipertestuali nei risultati visualizzati nella finestra del debugger. Il testo per questi collegamenti ipertestuali è stato lasciato negli esempi forniti per illustrare il formato esatto di ciò che verrà visualizzato quando si esegue il comando nel computer di debug. Alcuni esempi fanno anche riferimento in modo esplicito a fare clic su questi collegamenti per comprendere i flussi di utilizzo tipici, anche se gli esempi forniscono anche i moduli della riga di comando alternativi di ogni comando.

Parametri comuni

Tutti i comandi !ndiskd supportano i parametri generici seguenti.

-prolisso
Mostra dettagli aggiuntivi.

-conciso
Elimina un output boilerplate.

-statico
Elimina un output interattivo.

-dml 0|1
Controlla se l'output DML (debugger markup language) è abilitato.

-unicode 0|1
Controlla se l'output dei caratteri Unicode è consentito.

-Rientro N
Usa N spazi per livello di rientro.

-forza
Esegue l'override di alcuni controlli di sicurezza sulla integrità dei dati remoti.

-tracedata
Mostra messaggi di traccia dettagliati per eseguire il debug di !ndiskd.

Net Adapter, driver NDIS e comandi generali

I comandi seguenti visualizzano informazioni sulle schede di rete, i driver di rete e i comandi generali associati allo stack di rete, ad esempio rcvqueues, opens, filters, OID e RW locks.

comandi NET_BUFFER_LIST e NET_BUFFER

I comandi seguenti visualizzano informazioni relative alle strutture NET_BUFFER_LIST e NET_BUFFER.

Comandi NetAdapterCx

I comandi seguenti visualizzano informazioni relative all'estensione della classe WDF della scheda di rete NetAdapterCx e alle strutture associate, NET_RING_BUFFER e NET_PACKET.

Comandi dell'interfaccia di rete

I comandi seguenti visualizzano informazioni relative alle interfacce di rete.

comandi NDIS_PACKET

I comandi seguenti visualizzano informazioni sulle strutture NDIS_PACKET . Queste estensioni sono destinate ai driver NDIS 5.x legacy. La struttura NDIS_PACKET e l'architettura associata sono deprecate.

Comandi CoNDIS

I comandi seguenti visualizzano informazioni sulle connessioni NDIS orientate alla connessione.

Comandi di debug NDIS

I comandi seguenti visualizzano informazioni relative ai conteggi di riferimento NDIS, ai log eventi, alle analisi dello stack e alle tracce di debug.

Comandi WDI

I comandi seguenti visualizzano informazioni sui driver WDI Miniport.

Comandi informazioni NDIS e !ndiskd

I comandi seguenti visualizzano informazioni su NDIS.sys e ndiskd.dll.

Comandi vari

Per altre informazioni sulla progettazione di driver NDIS per Windows Vista e versioni successive, vedere Guida alla progettazione dei driver di rete.

Per altre informazioni di riferimento sui driver NDIS per Windows Vista e versioni successive, vedere Informazioni di riferimento sulla rete di Windows Vista e versioni successive.

Per una dimostrazione dell'uso dei comandi del debugger !ndiskd per eseguire il debug dello stack di rete, vedere il video Debug del canale 9 dello stack di rete.