Функция NdisFReturnNetBufferLists (ndis.h)

Статья
02/29/2024

Драйверы фильтров вызывают NdisFReturnNetBufferLists , чтобы освободить владение одной или несколькими NET_BUFFER_LIST структурами и связанными с ними структурами NET_BUFFER .

Синтаксис

void NdisFReturnNetBufferLists(
  [in] NDIS_HANDLE      NdisFilterHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG            ReturnFlags
);

Параметры

[in] NdisFilterHandle

Дескриптор NDIS, идентифицирующий этот модуль фильтра. NDIS передал дескриптор драйверу фильтра в вызове функции FilterAttach .

[in] NetBufferLists

Указатель на связанный список NET_BUFFER_LIST структур, которые должны быть возвращены базовому драйверу. Связанный список может содержать NET_BUFFER_LIST структуры из нескольких предыдущих вызовов Функция FilterReceiveNetBufferLists .

[in] ReturnFlags

Флаги NDIS, которые можно объединить с операцией OR. Чтобы очистить все флаги, установите для этого элемента нулевое значение. Эта функция поддерживает следующие флаги:

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

Указывает, что текущий irQL DISPATCH_LEVEL. Дополнительные сведения об этом флаге см. в разделе Dispatch IRQL Tracking.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

Если этот флаг установлен, все пакеты в связанном списке NET_BUFFER_LIST структур поступили из одного порта источника расширяемого коммутатора Hyper-V.

Дополнительные сведения см. в статье Флаги отправки и получения расширяемого коммутатора Hyper-V.

Примечание Если каждый пакет в связанном списке NET_BUFFER_LIST структур использует один и тот же исходный порт, расширение должно установить флаг NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE в параметре ReceiveFlagsобъекта NdisFIndicateReceiveNetBufferLists при отправке запроса.

Возвращаемое значение

None

Remarks

Если флаг NDIS_RECEIVE_FLAGS_RESOURCES в параметре ReceiveFlags , который NDIS передал вФункция FilterReceiveNetBufferLists не задана. Драйвер фильтра должен вызвать функцию NdisFReturnNetBufferLists, чтобы вернуть NET_BUFFER_LIST структуры и связанные данные. Когда драйвер фильтра вызывает NdisFReturnNetBufferLists, NDIS возвращает данные базовому драйверу.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_Filter_Driver_Function(ndis)