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


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

Модуль фильтров вызывает функцию выноски 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 путем вызова
функция FwpsvSwitchEventsSubscribe0 .

Если обратный вызов 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

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

Функции выноски драйвера выноски

FWPS_VSWITCH_EVENT_TYPE

FWPS_VSWITCH_PORT_EVENT_CALLBACK0

FilterDetach

FilterRestart

FwpsvSwitchEventsSubscribe0

FwpsvSwitchNotifyComplete0

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_PARAMETERS

NDIS_SWITCH_PORT_ARRAY

NdisFRestartComplete

OID_SWITCH_NIC_ARRAY

OID_SWITCH_PARAMETERS

OID_SWITCH_PORT_ARRAY