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

Статья
02/07/2025

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

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

Синтаксис

FWPS_NET_BUFFER_LIST_NOTIFY_FN0 FwpsNetBufferListNotifyFn0;

void FwpsNetBufferListNotifyFn0(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out, optional] 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, optional] netBufferList

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

[in, out, optional] newNetBufferList

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

[in] layerId

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

[in] context

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

[in] contextTag

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

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

Никакой

Замечания

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

Требования

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