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

Статья
02/07/2025

Модуль фильтров вызывает функцию выноски 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.
целевая платформа	Виндоус
заголовка	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL

См. также

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

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

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

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