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

Статья
02/07/2025

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

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

Синтаксис

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

Параметры

[in, out] netBufferList

Список сетевых буферов, указывающий один или несколько пакетов, интересующих драйвер выноски.

[in] layerId

Идентификатор слоя, в котором связан контекст. При вызове этой функции из пути получения NDIS задайте для этого параметра значение FWPS_LAYER_NON_WFP.

[in] context

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

[in] contextTag

Локальный уникальный идентификатор, полученный путем вызова функцию FwpsNetBufferListGetTagForContext0.

providerGuid

GUID поставщика.

[in, out] deviceObject

Указатель на объект устройства драйвера выноски.

[in] notifyFn

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

[in] flags

Этот параметр зарезервирован для дальнейшего использования и имеет значение нулю.

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

Функция FwpsNetBufferListAssociateContext1 возвращает один из следующих кодов NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Ассоциация была успешной.
Другие коды состояния	Произошла ошибка.

Замечания

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

Перед вызовом этой функции необходимо вызвать функцию FwpsNetBufferListGetTagForContext0, чтобы получить тег контекста.

Эта функция по сути идентична предыдущей версии.

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

Требования

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

См. также

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

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

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