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

  • Статья

Функция 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

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

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

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

Код возврата Описание
STATUS_SUCCESS
 Связь прошла успешно.
Другие коды состояния
 Произошла ошибка.

Комментарии

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

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

Требования

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

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

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

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