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

Статья
02/07/2025

Функция FwpsvSwitchEventsSubscribe0 регистрирует точки входа обратного вызова для событий уровня виртуального коммутатора, таких как создание и удаление виртуального порта.

ПримечаниеFwpsvSwitchEventsSubscribe0 — это определенная версия FwpsvSwitchEventsSubscribe. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Синтаксис

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

Параметры

providerGuid

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

notifyContext

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

flags

Скрытный. Установите значение нулю.

reserved

Скрытный. Установите значение нулю.

eventDispatchTable

Указатель на структуру FWPS_VSWITCH_EVENT_DISPATCH_TABLE, которая определяет точки входа обратного вызова для событий уровня виртуального коммутатора.

subscriptionId

Указатель на переменную, содержащую уникальный идентификатор, который МПП назначает подписке. Вызывающий объект должен вернуть идентификатор подписки в МПП с функцией FwpsvSwitchEventsUnsubscribe0.

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

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

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

Замечания

Драйвер выноски вызывает функцию FwpsvSwitchEventsSubscribe0, чтобы зарегистрировать точки входа обратного вызова для событий уровня виртуального коммутатора.

Точки входа для функций уведомлений обратного вызова указываются в структуре и FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 структуре.

Драйвер выноски должен позже вызвать FwpsvSwitchEventsUnsubscribe0, чтобы освободить системные ресурсы.

Требования

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

См. также

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0

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