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

Статья
08/07/2023

Модуль фильтрации вызывает функцию выноски 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

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

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

None

Remarks

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

Требования

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