функция обратного вызова FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 (fwpsk.h)

Статья
03/01/2024

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

ПримечаниеFWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 — это определенная версия FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .

Синтаксис

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 FwpsVswitchLifetimeEventCallback0;

NTSTATUS FwpsVswitchLifetimeEventCallback0(
  [in, optional] void *notifyContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_ARRAY *vSwitchPorts,
  [in, optional] const NDIS_SWITCH_NIC_ARRAY *vSwitchInterfaces
)
{...}

Параметры

[in, optional] notifyContext

Указатель на контекст, предоставляемый драйвером выноски. Драйвер передал этот указатель на параметр notifyContext функции FwpsvSwitchEventsSubscribe0 . Этот параметр является необязательным и может иметь значение NULL.

[in] eventType

Тип события виртуального коммутатора, указанный в качестве одного из значений перечисления FWPS_VSWITCH_EVENT_TYPE . Дополнительные сведения см. в подразделе "Примечания".

[in] vSwitch

Указатель на структуру NDIS_SWITCH_PARAMETERS , содержащую сведения о виртуальном коммутаторе.

Примечание Сведения в структуре NDIS_SWITCH_PARAMETERS отражают начальное состояние виртуального коммутатора, но не обязательно его текущее состояние. В частности, элементы NumSwitchPorts и IsActive могут по-прежнему иметь начальное значение 0, если не было активировано событие PnP виртуального коммутатора. Сведения о текущем состоянии можно найти в других параметрах этой функции обратного вызова.

[in, optional] vSwitchPorts

Указатель на структуру NDIS_SWITCH_PORT_ARRAY , указывающую массив параметров конфигурации порта. Каждый элемент в массиве задает параметры для порта на виртуальном коммутаторе.

[in, optional] vSwitchInterfaces

Указатель на структуру NDIS_SWITCH_NIC_ARRAY , указывающую массив параметров конфигурации адаптера мини-порта. Каждый элемент в массиве задает параметры для виртуального или физического адаптера мини-порта, подключенного к порту на виртуальном коммутаторе.

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

Выноска

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

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

Если обратный вызов vSwitchLifetimeNotifyFn зарегистрирован, драйвер фильтра МПП уведомляет драйвер выноски при создании экземпляра виртуального коммутатора. На узле Hyper-V одновременно может присутствовать несколько экземпляров виртуального коммутатора.

Драйвер фильтра МПП запрашивает OID OID_SWITCH_PARAMETERS в функции FilterRestart , чтобы получить идентификатор виртуального коммутатора, связанный с текущим экземпляром виртуального коммутатора. Драйвер фильтра МПП также запрашивает OID_SWITCH_NIC_ARRAY и OID_SWITCH_PORT_ARRAY OID, чтобы получить начальный набор настроенных виртуальных сетевых адаптеров и виртуальных портов. Драйвер фильтра МПП передает NDIS_SWITCH_PORT_ARRAY и NDIS_SWITCH_NIC_ARRAY сведения о структуре из OID в vSwitchLifetimeNotifyFn с FWPS_VSWITCH_EVENT_VSWITCH_CREATE, заданным в параметре eventType .

В параметре FilterDetach драйвера фильтра ПППП вызывается FWPS_VSWITCH_EVENT_VSWITCH_DELETE, заданный в параметре eventTypevSwitchLifetimeNotifyFn .

Драйвер выноски не может возвращать STATUS_PENDING из vSwitchLifetimeNotifyFn.

Требования

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