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

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

  • Статья

Функция 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
 Контекст успешно удален.
Другие коды состояния
 Произошла ошибка.

Комментарии

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

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

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

Требования

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

См. также раздел

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

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