Функция FwpsNetBufferListRemoveContext0 (fwpsk.h)

Статья
08/07/2023

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

ПримечаниеFwpsNetBufferListRemoveContext0 — это определенная версия FwpsNetBufferListRemoveContext. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Синтаксис

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

Параметры

[in, out, optional] netBufferList

Список сетевого буфера, указывающий один или несколько пакетов, представляющих интерес для драйвера выноски. Этот параметр является необязательным и может иметь значение NULL. Если значение равно NULL, функция удалит контекст из всех связанных списков сетевых буферов.

[in] contextTag

Тег контекста, переданный в параметре contextTag в FwpsNetBufferListAssociateContext0.

[in] flags

Этот параметр зарезервирован для дальнейшего использования и должен быть равен нулю.

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

Функция FwpsNetBufferListRemoveContext0 возвращает один из следующих кодов NTSTATUS .

Код возврата	Описание
STATUS_SUCCESS	Контекст успешно удален.
Другие коды состояния	Произошла ошибка.

Обычно драйверу выноски не нужно использовать эту функцию, так как контекст с тегами удаляется автоматически при перемещении пакетов через стек. Эта функция предоставляется для того, чтобы драйвер выноски смог остановить обработку в ситуациях, когда контексты не удаляются автоматически. Например, в случае драйвера фильтра NDIS пакеты никогда не попадают в стек TCP/IP, а контексты необходимо удалить вручную, вызвав FwpsNetBufferListRemoveContext0 с параметром netBufferList , имеющим значение NULL.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 7.
Целевая платформа	Универсальное
Верхняя часть	fwpsk.h (включая Fwpsk.h)
Библиотека	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL