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

Статья
02/07/2025

Функция 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 contextTag, FwpsNetBufferListAssociateContext0.

[in] flags

Этот параметр зарезервирован для будущего использования и должен иметь нулевое значение.

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

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

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

Замечания

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

Чтобы связать контекст со списком сетевых буферов, вызовите FwpsNetBufferListAssociateContext0 или FwpsNetBufferListAssociateContext1.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 7.
целевая платформа	Всеобщий
заголовка	fwpsk.h (include Fwpsk.h)
библиотеки	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

См. также

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

использование тегов пакетов

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