NET_BUFFER_LIST-Struktur

  • Artikel

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

Die folgende Abbildung zeigt die Felder in einer NET_BUFFER_LIST-Struktur.

Diagramm, das die Felder in einer NET_BUFFER_LIST-Struktur veranschaulicht.

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

Einige der Member werden nur von NDIS verwendet. Die Member, die treiber wahrscheinlich verwenden, sind in der folgenden Liste definiert:

ParentNetBufferList
Wenn eine NET_BUFFER_LIST-Struktur ein untergeordnetes Element ist, das von einem übergeordneten (geklont, fragmentiert oder neu zusammengesetzt) abgeleitet wurde, gibt ParentNetBufferList einen Zeiger auf die übergeordnete NET_BUFFER_LIST-Struktur an. Andernfalls ist dieser Parameter NULL.

NdisPoolHandle
Gibt ein Poolhandle an, das den NET_BUFFER_LIST Pools 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 hat:

Miniporttreiber
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 eine NET_BUFFER_LIST-Struktur ein übergeordnetes Element ist (mit untergeordneten Elementen, die durch Klon-, Fragment- oder Neuassemblevorgänge abgeleitet werden), gibt ChildRefCount die Anzahl der vorhandenen untergeordneten Elemente an. Andernfalls ist dieser Parameter 0.

Flags
Reserviert für die zukünftige Spezifikation von Attributen für die NET_BUFFER_LIST-Struktur. Treibern stehen derzeit keine Flags zur Verfügung.

Status
Gibt den endgültigen Abschluss status eines Netzwerkdatenvorgangs für diese NET_BUFFER_LIST-Struktur an. Miniporttreiber schreiben diesen Wert vor Abschluss eines Sendevorgangs.

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-Daten (OOB) bezeichnet.

Nächster
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 unter Kontext bereit. Weitere Informationen zur NET_BUFFER_LIST_CONTEXT-Struktur finden Sie unter NET_BUFFER_LIST_CONTEXT-Struktur.