Share via

NDIS-Erweiterungen (Ndiskd.dll)

  • Artikel

In diesem Abschnitt werden befehle beschrieben, die in !ndiskd verfügbar sind, einer Debuggererweiterung, die zum Debuggen von NDIS-Treibern (Network Device Interface Specification) nützlich ist. Diese Befehle ermöglichen es Netzwerktreiberentwicklern, ein größeres Bild des Windows-Netzwerkstapels und der Interaktion ihrer Treiber zu sehen. Mit !ndiskd können Sie den Zustand aller Netzwerkadapter (!ndiskd.netadapter), ein visuelles Diagramm des Netzwerkstapels des Computers (!ndiskd.netreport), ein Protokoll des Datenverkehrs auf den Netzwerkadaptern(!ndiskd.nbllog) oder eine Liste aller ausstehenden OID-Anforderungen (!ndiskd.oid) anzeigen.

Die Befehle finden Sie in Ndiskd.dll. Um die Symbole zu laden, geben Sie . reload /f ndis.sys in das Debuggerbefehlsfenster ein. Um zu bestätigen, dass die Symbole erfolgreich geladen wurden, verwenden Sie die Erweiterung !lmi ndis , und suchen Sie nach dem Ausdruck "Symbole erfolgreich geladen" nach unten. Ihre Ausgabe sollte etwa folgendem Beispiel entsprechen:

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

Viele der Erweiterungsbefehle in !ndiskd enthalten Links in den Ergebnissen, die im Debuggerfenster angezeigt werden. Der Text für diese Hyperlinks wurde in den bereitgestellten Beispielen erhalten, um das genaue Format dessen zu veranschaulichen, was beim Ausführen des Befehls auf Dem Debugcomputer angezeigt wird. Einige der Beispiele beziehen sich auch explizit auf das Klicken auf diese Links, sodass Sie typische Verwendungsflüsse verstehen können, obwohl die Beispiele auch die alternativen Befehlszeilenformen der einzelnen Befehle bereitstellen.

Allgemeine Parameter

Alle !ndiskd-Befehle unterstützen die folgenden generischen Parameter.

-Ausführliche
Zeigt zusätzliche Details an.

-Knappe
Unterdrückt einen teil der Boilerplate-Ausgabe.

-Statische
Unterdrückt eine interaktive Ausgabe.

-dml 0|1
Steuert, ob die DML-Ausgabe (Debugger-Markupsprache) aktiviert ist.

-unicode 0|1
Steuert, ob die Unicode-Zeichenausgabe zulässig ist.

-Einzug N
Verwendet N Leerzeichen pro Einzugsebene.

-Kraft
Überschreibt einige Sicherheitsüberprüfungen für Remotedaten.

-Tracedata
Zeigt ausführliche Ablaufverfolgungsmeldungen an, um !ndiskd selbst zu debuggen.

Net Adapter, NDIS-Treiber und allgemeine Befehle

Die folgenden Befehle zeigen Informationen zu den Netzwerkadaptern, Netzwerktreibern und allgemeinen Befehlen des Computers an, die dem Netzwerkstapel zugeordnet sind (z. B. rcvqueues, opens, Filter, OIDs und RW-Sperren).

befehle NET_BUFFER_LIST und NET_BUFFER

Die folgenden Befehle zeigen Informationen zu NET_BUFFER_LIST und NET_BUFFER Strukturen an.

NetAdapterCx-Befehle

Die folgenden Befehle zeigen Informationen zur Netzwerkadapter-WDF-Klassenerweiterung NetAdapterCx und den zugehörigen Strukturen , NET_RING_BUFFER und NET_PACKET an.

Befehle der Netzwerkschnittstelle

Die folgenden Befehle zeigen Informationen zu Netzwerkschnittstellen an.

NDIS_PACKET-Befehle

Die folgenden Befehle zeigen Informationen zu NDIS_PACKET Strukturen an. Diese Erweiterungen sind für Ältere NDIS 5.x-Treiber vorgesehen. Die NDIS_PACKET-Struktur und die zugehörige Architektur sind veraltet.

CoNDIS-Befehle

Die folgenden Befehle zeigen Informationen zu verbindungsorientierten NDIS-Verbindungen an.

NDIS-Debugbefehle

Die folgenden Befehle zeigen Informationen zu NDIS-Refcounts, Ereignisprotokollen, Stapelablaufverfolgungen und Debugablaufverfolgungen an.

WDI-Befehle

Die folgenden Befehle zeigen Informationen zu WDI-Miniporttreibern an.

NDIS- und !ndiskd-Informationsbefehle

Die folgenden Befehle zeigen Informationen zu NDIS.sys und ndiskd.dll an.

Verschiedene Befehle

Weitere Informationen zum Entwerfen von NDIS-Treibern für Windows Vista und höher finden Sie im Handbuch zum Entwerfen von Netzwerktreibern.

Weitere Informationen zur Referenz zu NDIS-Treibern für Windows Vista und höher finden Sie unter Windows Vista und spätere Netzwerkreferenz.

Eine Demonstration der Verwendung der !ndiskd-Debuggerbefehle zum Debuggen des Netzwerkstapels finden Sie im Video Debuggen des Netzwerkstapelkanals 9.