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

Статья
02/29/2024

Драйверы фильтров вызывают функцию NdisFSendNetBufferListsComplete , чтобы возвращать связанный список NET_BUFFER_LIST структур в вышестоящему драйверу и возвращать окончательное состояние запроса на отправку.

Синтаксис

void NdisFSendNetBufferListsComplete(
  [in] NDIS_HANDLE      NdisFilterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

Параметры

[in] NdisFilterHandle

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

NetBufferList

Указатель на связанный список NET_BUFFER_LIST структур. Драйвер фильтра получил структуры NET_BUFFER_LIST в предыдущих вызовахФункция FilterSendNetBufferLists.

[in] SendCompleteFlags

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

NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

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

NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE

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

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

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

Примечание Этот флаг доступен в NDIS 6.30 и более поздних версиях.

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

None

Remarks

Драйвер фильтра вызывает функцию NdisFSendNetBufferListsComplete для завершения отправки запросов, выполненных NDIS в драйвер.Функция FilterSendNetBufferLists. Драйвер фильтра задает связанный список NET_BUFFER_LIST структур, связанных с завершенными запросами на отправку. Пока состояние запросов на отправку находится в состоянии ожидания, драйвер фильтра сохраняет за собой право собственности на структуры NET_BUFFER_LIST и все ресурсы, связанные с NET_BUFFER_LIST структурами.

Драйвер фильтра может выполнять отправку запросов в любом порядке. Например, драйвер фильтра может объединить NET_BUFFER_LIST списки структуры из нескольких вызовов FilterSendNetBufferLists или разделить список из вызова FilterSendNetBufferLists . Однако драйвер фильтра не должен изменять список NET_BUFFER структур, связанных со структурой NET_BUFFER_LIST .

Примечание Драйвер фильтра должен отслеживать исходящие запросы на отправку и убедиться, что он не вызываетФункция NdisFSendNetBufferListsComplete при выполнении таких запросов.

Требования

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