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

Статья
02/07/2025

Драйверы фильтров вызывают 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. Дополнительные сведения об этом флаге см. в отслеживания IRQL.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

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

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

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

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

Никакой

Замечания

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

Требования

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