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

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

  • Статья

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

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

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0