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

Статья
02/07/2025

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

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

Синтаксис

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 notifyFn,
  [in]      UINT32                          flags
);

Параметры

[in, out] netBufferList

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

[in] layerId

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

[in] context

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

[in] contextTag

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

providerGuid

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

[in, out] deviceObject

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

[in] notifyFn

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

[in] flags

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

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

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

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

Замечания

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

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

Требования

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

См. также

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

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

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