Поделиться через

Структура NET_BUFFER_LIST

Структура NET_BUFFER_LIST упаковывает связный список структур NET_BUFFER.

На следующем рисунке показаны поля в NET_BUFFER_LIST структуре.

диаграмма, иллюстрирующая поля в структуре NET_BUFFER_LIST.

Структура NET_BUFFER_LIST включает структуру NET_BUFFER_LIST_HEADER в элементе NetBufferListHeader. Структура NET_BUFFER_LIST_HEADER включает структуру NET_BUFFER_LIST_DATA в элементе NetBufferListData. Для доступа к элементам структуры NET_BUFFER_LIST следует использовать макросы NDIS. Дополнительные сведения об этих макросах см. на странице справочника по структуре NET_BUFFER_LIST.

Некоторые члены используются только NDIS. Члены, которые водители, скорее всего, будут использовать, определены в следующем списке:

ParentNetBufferList
Если структура NET_BUFFER_LIST является дочерним элементом, производным от родительской структуры (клонированного, фрагментированного или собранного заново), ParentNetBufferList указывает на родительскую структуру NET_BUFFER_LIST. В противном случае этот параметр NULL.

NdisPoolHandle
Указывает идентификатор пула, определяющий пул NET_BUFFER_LIST, из которого была выделена структура NET_BUFFER_LIST.

ProtocolReserved
Зарезервировано для использования драйверами протокола.

MiniportReserved
Зарезервировано под использование минипорт драйверами.

SourceHandle
Дескриптор, который NDIS предоставил драйверу в операции привязки или присоединения, с использованием одной из следующих подпрограмм, предоставленных драйвером:

драйвер минипорта
MiniportInitializeEx

Драйвер протокола
ProtocolBindAdapterEx

Драйвер фильтра
FilterAttach

NDIS использует SourceHandle для возврата структуры NET_BUFFER_LIST драйверу, который отправил эту структуру. Драйверы NDIS не должны читать данный дескриптор.

ChildRefCount
Если структура NET_BUFFER_LIST является родительской (имеет дочерние элементы, производные от клона, фрагмента или повторного выполнения операций), ChildRefCount указывает число существующих дочерних элементов. В противном случае этот параметр равен нулю.

Флаги
Зарезервировано для будущей спецификации атрибутов для структуры NET_BUFFER_LIST. В настоящее время нет флагов, доступных драйверам.

статус
Указывает окончательное состояние завершения операции сетевых данных для этой NET_BUFFER_LIST структуры. Драйверы минипорта записывают это значение перед завершением операции отправки.

NetBufferListInfo
Указывает NET_BUFFER_LIST сведения о структуре, общие для всех NET_BUFFER структур в списке. Эта информация часто называется "внештатными данными" (OOB).

следующей
Указывает указатель на следующую структуру NET_BUFFER_LIST в связанном списке структур NET_BUFFER_LIST. Если NET_BUFFER_LIST структура является последней структурой в списке, этот элемент NULL.

FirstNetBuffer
Задает указатель на первую структуру NET_BUFFER в связанном списке структур NET_BUFFER, ассоциированных с данной структурой NET_BUFFER_LIST.

ПримечаниеКонтекст — это указатель на структуру NET_BUFFER_LIST_CONTEXT. NDIS предоставляет макросы и функции для управления данными в контексте . Дополнительные сведения о структуре NET_BUFFER_LIST_CONTEXT см. в разделе Структура NET_BUFFER_LIST_CONTEXT.