Partager via

Extensions NDIS (Ndiskd.dll)

  • Article

Cette section décrit les commandes disponibles dans !ndiskd, une extension de débogueur utile pour le débogage des pilotes NDIS (Network Device Interface Specification). Ces commandes permettent aux développeurs de pilotes réseau de voir une vue d’ensemble de la pile de mise en réseau Windows et de la façon dont leurs pilotes interagissent avec celui-ci. Avec !ndiskd, vous pouvez voir l’état de toutes les cartes réseau ( !ndiskd.netadapter), un diagramme visuel de la pile réseau de l’ordinateur ( !ndiskd.netreport), un journal du trafic sur les cartes réseau ( !ndiskd.nbllog) ou une liste de toutes les requêtes OID en attente ( !ndiskd.oid).

Les commandes sont disponibles dans Ndiskd.dll. Pour charger les symboles, entrez .reload /f ndis.sys dans la fenêtre de commande du débogueur. Pour confirmer que les symboles sont correctement chargés, utilisez l’extension !lmi ndis et recherchez l’expression « Symboles chargés correctement » vers le bas. Vous devez obtenir un résultat semblable à l’exemple qui suit :

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

La plupart des commandes d’extension dans !ndiskd vous présentent des liens hypertexte dans les résultats qu’ils affichent dans la fenêtre du débogueur. Le texte de ces liens hypertexte a été laissé dans les exemples fournis pour illustrer le format exact de ce que vous verrez lors de l’exécution de la commande sur votre ordinateur de débogage. Certains exemples font également référence explicitement à cliquer sur ces liens afin de comprendre les flux d’utilisation classiques, bien que les exemples fournissent également les autres formulaires de ligne de commande de chaque commande.

Paramètres communs

Toutes les commandes !ndiskd prennent en charge les paramètres génériques suivants.

-verbeux
Affiche des informations supplémentaires.

-laconique
Supprime une sortie réutilisable.

-statique
Supprime une sortie interactive.

-dml 0|1
Contrôle si la sortie DML (langage de balisage du débogueur) est activée.

-unicode 0|1
Contrôle si la sortie de caractères Unicode est autorisée.

-retrait N
Utilise n espaces par niveau de retrait.

-force
Remplace certaines vérifications de sécurité sur la santé des données distantes.

-tracedata
Affiche les messages de trace détaillés pour déboguer !ndiskd lui-même.

Adaptateur Net, pilote NDIS et commandes générales

Les commandes suivantes affichent des informations sur les cartes réseau, les pilotes réseau et les commandes générales associées à la pile réseau (telles que rcvqueues, ouvre, filtres, OID et verrous RW).

commandes NET_BUFFER_LIST et NET_BUFFER

Les commandes suivantes affichent des informations relatives aux structures NET_BUFFER_LIST et NET_BUFFER.

Commandes NetAdapterCx

Les commandes suivantes affichent des informations relatives à l’extension de classe WDF de carte réseau NetAdapterCx et à ses structures associées, NET_RING_BUFFER et NET_PACKET.

Commandes d’interface réseau

Les commandes suivantes affichent des informations relatives aux interfaces réseau.

Commandes NDIS_PACKET

Les commandes suivantes affichent des informations sur les structures NDIS_PACKET . Ces extensions sont destinées aux pilotes NDIS 5.x hérités. La structure NDIS_PACKET et son architecture associée ont été dépréciées.

Commandes CoNDIS

Les commandes suivantes affichent des informations sur les connexions NDIS orientées connexion.

Commandes de débogage NDIS

Les commandes suivantes affichent des informations relatives aux refcounts NDIS, aux journaux d’événements, aux traces de pile et aux traces de débogage.

Commandes WDI

Les commandes suivantes affichent des informations sur les pilotes Miniport WDI.

Commandes d’informations NDIS et !ndiskd

Les commandes suivantes affichent des informations sur les NDIS.sys et les ndiskd.dll.

Commandes diverses

Pour plus d’informations sur la conception de pilotes NDIS pour Windows Vista et versions ultérieures, consultez le Guide de conception des pilotes réseau.

Pour plus d’informations sur les informations de référence sur les pilotes NDIS pour Windows Vista et versions ultérieures, consultez Informations de référence sur la mise en réseau windows Vista et versions ultérieures.

Pour une démonstration de l’utilisation des commandes du débogueur !ndiskd pour déboguer la pile réseau, consultez la vidéo Débogage de la pile réseau 9.