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 d’avoir une vue d’ensemble de la pile réseau Windows et de la façon dont leurs pilotes interagissent avec celle-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 se trouvent 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 ont été correctement chargés, utilisez l’extension !lmi ndis et recherchez l’expression « Symboles chargés avec succès » en 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’elles 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 lorsque vous exécuterez la commande sur votre ordinateur de débogage. Certains exemples font également référence explicitement à un clic sur ces liens afin que vous puissiez comprendre les flux d’utilisation classiques, bien que les exemples fournissent également les autres formes de ligne de commande de chaque commande.

Paramètres communs

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

-Verbose
Affiche des détails 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.

-indent N
Utilise N espaces par niveau de retrait.

-Force
Remplace certaines vérifications de sécurité sur l’intégrité des données distantes.

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

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

Les commandes suivantes affichent des informations sur les cartes réseau de l’ordinateur, les pilotes réseau et les commandes générales associées à la pile réseau (telles que les rcvqueues, les ouvertures, les filtres, les OID et les 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 la 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 NDIS_PACKET structures. 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éconseillé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 WDI Miniport.

Commandes NDIS et !ndiskd Information

Les commandes suivantes affichent des informations sur NDIS.sys et 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 windows vista et mise en réseau ultérieure.

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 canal 9.