NET_BUFFER_LIST Struktur

Eine NET_BUFFER_LIST Struktur verpackt eine verknüpfte Liste von NET_BUFFER Strukturen.

Die folgende Abbildung zeigt die Felder in einer NET_BUFFER_LIST Struktur.

Die NET_BUFFER_LIST-Struktur enthält eine NET_BUFFER_LIST_HEADER Struktur im NetBufferListHeader Member. Die NET_BUFFER_LIST_HEADER-Struktur enthält eine NET_BUFFER_LIST_DATA Struktur im NetBufferListData--Element. Sie sollten NDIS-Makros verwenden, um auf NET_BUFFER_LIST Strukturmmber zuzugreifen. Weitere Informationen zu diesen Makros finden Sie auf der NET_BUFFER_LIST Strukturreferenzseite.

Einige der Member werden nur von NDIS verwendet. Die Elemente, die Treiber am ehesten verwenden, werden in der folgenden Liste definiert:

ParentNetBufferList-
Wenn eine NET_BUFFER_LIST Struktur ein untergeordnetes Element ist, das von einer übergeordneten(geklonten, fragmentierten oder erneuten Zusammenbauung) abgeleitet wurde, gibt ParentNetBufferList einen Zeiger auf die übergeordnete NET_BUFFER_LIST Struktur an. Andernfalls ist dieser Parameter NULL-.

NdisPoolHandle-
Gibt einen Poolhandle an, der den NET_BUFFER_LIST Pool identifiziert, aus dem die NET_BUFFER_LIST Struktur zugeordnet wurde.

ProtocolReserved-
Reserviert für die Verwendung durch Protokolltreiber.

MiniportReserved
Reserviert für die Verwendung durch Miniporttreiber.

SourceHandle-
Ein Handle, das NDIS dem Treiber in einem Bindungs- oder Anfügenvorgang mithilfe einer der folgenden vom Treiber bereitgestellten Routinen bereitgestellt wird:

Miniport-Treiber
MiniportInitializeEx

Protokolltreiber
ProtocolBindAdapterEx-

Filtertreiber
FilterAttach-

NDIS verwendet SourceHandle-, um die NET_BUFFER_LIST Struktur an den Treiber zurückzugeben, der die NET_BUFFER_LIST Struktur gesendet hat. NDIS-Treiber sollten dieses Handle nicht lesen.

ChildRefCount-
Wenn es sich bei einer NET_BUFFER_LIST-Struktur um ein übergeordnetes Element (mit untergeordneten Elementen handelt, die durch Klon-, Fragment- oder Neuassemble-Vorgänge abgeleitet sind), gibt ChildRefCount- die Anzahl vorhandener untergeordneter Elemente an. Andernfalls ist dieser Parameter null.

Flags
Reserviert für die zukünftige Spezifikation von Attributen für die NET_BUFFER_LIST-Struktur. Für Treiber sind derzeit keine Kennzeichnungen verfügbar.

Status-
Gibt den endgültigen Abschlussstatus eines Netzwerkdatenvorgangs für diese NET_BUFFER_LIST Struktur an. Miniport-Treiber schreiben diesen Wert, bevor sie einen Sendevorgang abschließen.

NetBufferListInfo-
Gibt NET_BUFFER_LIST Strukturinformationen an, die allen NET_BUFFER Strukturen in der Liste gemeinsam sind. Diese Informationen werden häufig als "Out-of-Band(OOB)-Daten" bezeichnet.

Nächste
Gibt einen Zeiger auf die nächste NET_BUFFER_LIST Struktur in einer verknüpften Liste von NET_BUFFER_LIST Strukturen an. Wenn eine NET_BUFFER_LIST Struktur die letzte Struktur in der Liste ist, ist dieses Element NULL-.

FirstNetBuffer-
Gibt einen Zeiger auf die erste NET_BUFFER Struktur in einer verknüpften Liste von NET_BUFFER Strukturen an, die dieser NET_BUFFER_LIST Struktur zugeordnet sind.

HinweisKontext- ist ein Zeiger auf eine NET_BUFFER_LIST_CONTEXT Struktur. NDIS stellt Makros und Funktionen zum Bearbeiten der Daten an Context bereit. Weitere Informationen zur NET_BUFFER_LIST_CONTEXT Struktur finden Sie unter NET_BUFFER_LIST_CONTEXT Structure.