!ndiskd.netrb

Artikel
07/08/2024

Die Erweiterung !ndiskd.netrb zeigt Informationen über eine NET_RING_BUFFER-Struktur an.

Weitere Informationen über die Netzwerkadapter-WDF-Klassenerweiterung (NetAdapterCx) finden Sie unter Netzwerkadapter-WDF-Klassenerweiterung (Cx).

!ndiskd.netrb -handle <x> [-basic] [-dump] [-elementtype <str>]

Parameter

-Griff
Erforderlich. Adresse eines NET_RING_BUFFERs.

-grundlegend
Zeigt grundlegende Informationen an.

-Müllkippe
Zeigt Informationen über jedes Element im NET_RING_BUFFER an.

-elementtype
Eine Zeichenkette für den Datentyp, der zu verwenden ist, wenn auf ein Ringpufferelement verwiesen wird.

DLL

Ndiskd.dll

Beispiele

Hinweis Siehe Zusammenfassung der Objekte, um ein Diagramm zu sehen, das die Beziehung des NET_RING_BUFFER-Objekts zu anderen Objekten im NetAdapterCx erklärt.

Um ein Handle für einen NET_RING_BUFFER zu erhalten, gehen Sie wie folgt vor:

Führen Sie die Erweiterung !ndiskd.netadapter aus.
Klicken Sie auf den Handle für einen NetAdapter, der einen NetAdapterCx-Treiber installiert hat.
Klicken Sie auf den Link „More Information“ (Weitere Informationen) rechts neben dem NETADAPTER-Objekt des NetAdapters, um die Erweiterung !ndiskd.cxadapter auszuführen.
Geben Sie den Befehl !ndiskd.cxadapter mit dem Parameter -datapath ein, um die Datenpfad-Warteschlangen dieses NETADAPTERs zu sehen.
Klicken Sie auf den Handle für eine der Datenpfad-Warteschlangen.

Einzelheiten zu den Schritten 1-4 dieses Verfahrens finden Sie in den Beispielen unter !ndiskd.cxadapter. Einzelheiten zu Schritt 5 dieses Verfahrens finden Sie in den Beispielen unter !ndiskd.netqueue. Im folgenden Beispiel suchen Sie nach dem Handle für den Ringpuffer dieser NETTXQUEUE, ffffd1022d000000.

0: kd> !ndiskd.netqueue ffffd1022f512700

    NETTXQUEUE         00002efdd0aed9a8
    Ring buffer        ffffd1022d000000

    Switch to EC thread

    Event Callbacks                        Function pointer   Symbol (if available)
    EvtQueueAdvance                        fffff80034152af8   RtEthSample+2af8
    EvtQueueArmNotification                fffff80034159a94   RtEthSample+9a94
    EvtQueueCancel                         fffff800341598d8   RtEthSample+98d8

Wenn Sie auf das Handle für den Ringpuffer klicken oder den Befehl !ndiskd.netrb -handle in die Befehlszeile eingeben, können Sie Details zu diesem NET_RING_BUFFER sehen, einschließlich der Anzahl der Elemente, die er enthält, und der Adresse seiner Anfangs- und Endindizes.

0: kd> !ndiskd.netrb ffffd1022d000000

    NET_RING    ffffd1022d000000

    Number of elements 0x080
    Owned by OS        0x080
    Owned by Client    00000

    Begin Index        0x078 (ffffd1022d003c40 - NET_PACKET)
    Next Index         0x078 (ffffd1022d003c40 - NET_PACKET)
    End Index          0x078 (ffffd1022d003c40 - NET_PACKET)

    List all elements

Um die Elemente dieses NET_RING_BUFFERs anzuzeigen, klicken Sie entweder auf den Link „Alle Elemente auflisten“ am unteren Rand der Details oder geben Sie den Befehl !ndiskd.netrb -dump in die Befehlszeile ein. Bei dem folgenden Beispiel wurden die mittleren Elemente der Kürze halber weggelassen.

0: kd> !ndiskd.netrb ffffd1022d000000 -dump

    [000] ffffd1022d000040 - NET_PACKET
    [001] ffffd1022d0000c0 - NET_PACKET
    [002] ffffd1022d000140 - NET_PACKET
    [003] ffffd1022d0001c0 - NET_PACKET
    [004] ffffd1022d000240 - NET_PACKET
    [005] ffffd1022d0002c0 - NET_PACKET
    
    ...

    [07b] ffffd1022d003dc0 - NET_PACKET
    [07c] ffffd1022d003e40 - NET_PACKET
    [07d] ffffd1022d003ec0 - NET_PACKET
    [07e] ffffd1022d003f40 - NET_PACKET
    [07f] ffffd1022d003fc0 - NET_PACKET