Struktura NET_BUFFER_LIST

Struktura NET_BUFFER_LIST pakuje połączoną listę struktur NET_BUFFER.

Na poniższej ilustracji przedstawiono pola w strukturze NET_BUFFER_LIST.

Struktura NET_BUFFER_LIST zawiera strukturę NET_BUFFER_LIST_HEADER w składowej NetBufferListHeader . Struktura NET_BUFFER_LIST_HEADER zawiera strukturę NET_BUFFER_LIST_DATA w elemencie NetBufferListData. Aby uzyskać dostęp do składowych struktury NET_BUFFER_LIST, należy użyć makr NDIS. Aby uzyskać więcej informacji na temat tych makr, zobacz stronę referencyjną struktury NET_BUFFER_LIST.

Niektóre elementy są używane tylko przez NDIS. Członkowie, których sterowniki najprawdopodobniej używają, są zdefiniowane na poniższej liście:

ParentNetBufferList
Jeśli struktura NET_BUFFER_LIST jest elementem podrzędnym pochodzącym z elementu nadrzędnego (sklonowanego, pofragmentowanego lub ponownie zmontowanego), ParentNetBufferList określa wskaźnik do struktury NET_BUFFER_LIST nadrzędnej. W przeciwnym razie ten parametr jest null.

NdisPoolHandle
Określa uchwyt puli, który identyfikuje pulę NET_BUFFER_LIST, z której przydzielono strukturę NET_BUFFER_LIST.

ProtocolReserved
Zarezerwowane do użytku przez sterowniki protokołów.

MiniportReserved
Zarezerwowane do użytku przez sterowniki miniportu.

SourceHandle
Uchwyt udostępniony sterownikowi przez NDIS w operacji powiązania lub dołączania przy użyciu jednej z następujących procedur dostarczanych przez sterownik:

sterownik Miniport
MiniportInitializeEx

Sterownik protokołu
ProtocolBindAdapterEx

Sterownik filtru
FilterAttach

Usługa NDIS używa SourceHandle, aby odesłać strukturę NET_BUFFER_LIST do sterownika, który tę strukturę wysłał. Sterowniki NDIS nie powinny odczytywać tego uchwytu.

ChildRefCount
Jeśli struktura NET_BUFFER_LIST jest rodzicem (ma elementy podrzędne pochodne przez operacje klonowania, fragmentacji lub ponownego zestawienia), ChildRefCount określa liczbę istniejących elementów podrzędnych. W przeciwnym razie ten parametr ma wartość zero.

Flagi
Zarezerwowane dla przyszłej specyfikacji atrybutów struktury NET_BUFFER_LIST. Obecnie nie ma żadnych flag dostępnych dla sterowników.

Status
Określa końcowy stan ukończenia operacji danych sieciowych dla tej struktury NET_BUFFER_LIST. Sterowniki Miniport zapisują tę wartość przed ukończeniem operacji wysyłania.

NetBufferListInfo
Określa informacje o strukturze NET_BUFFER_LIST wspólne dla wszystkich struktur NET_BUFFER na liście. Te informacje są często określane jako "dane poza pasmem (OOB).

Następne
Określa wskaźnik do następnej struktury NET_BUFFER_LIST na połączonej liście struktur NET_BUFFER_LIST. Jeśli struktura NET_BUFFER_LIST jest ostatnią strukturą na liście, ten element członkowski jest null.

FirstNetBuffer
Określa wskaźnik do pierwszej struktury NET_BUFFER na połączonej liście struktur NET_BUFFER skojarzonych z tą strukturą NET_BUFFER_LIST.

UwagaKontekst to wskaźnik do struktury NET_BUFFER_LIST_CONTEXT. NDIS udostępnia makra i funkcje do manipulowania danymi w Context. Aby uzyskać więcej informacji na temat struktury NET_BUFFER_LIST_CONTEXT, zobacz NET_BUFFER_LIST_CONTEXT Structure.