функция обратного вызова FWPS_NET_BUFFER_LIST_NOTIFY_FN1 (fwpsk.h)

Статья
08/07/2023

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

Обратите внимание, FWPS_NET_BUFFER_LIST_NOTIFY_FN1 — это конкретная версия FWPS_NET_BUFFER_LIST_NOTIFY_FN, используемая в Windows 8 и более поздних версиях. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows . Для Windows 7 доступно FWPS_NET_BUFFER_LIST_NOTIFY_FN0 .

Синтаксис

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

Параметры

[in] eventType

Значение типа , указывающее тип уведомления, которое обработчик фильтров отправляет в выноску. Этому параметру будет присвоено одно из значений перечисление FWPS_NET_BUFFER_LIST_EVENT_TYPE0 .

[in, out] netBufferList

Указатель на список буферов, содержащий пакеты, которые ранее были помечены драйвером выноски как интересные.

[in, out, optional] newNetBufferList

Указатель на обновленный список буферов, содержащий пакеты, интересные драйверу выноски. Использование этого параметра зависит от типа события. Для событий, в которых в указанный пакет внесено изменение, измененная версия передается в качестве этого параметра.

[in] layerId

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

[in] context

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

[in] contextTag

Тег контекста, используемый для связывания интересующих пакетов с контекстом драйвера выноски.

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

Выноска FWPS_NET_BUFFER_LIST_NOTIFY_FN1 функция возвращает один из следующих кодов NTSTATUS.

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

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

Эта функция идентична FWPS_NET_BUFFER_LIST_NOTIFY_FN0, за исключением того, что тип возвращаемого значения — NTSTATUS , а не VOID.

Требования

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

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

Функции выноски драйвера выноски

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

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