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

  • Статья

Функция 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 (включая Fwpsk.h)
Библиотека Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

См. также раздел

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

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