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

Статья
08/07/2023

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

Обратите вниманиеFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 — это определенная версия FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Синтаксис

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;

NTSTATUS FwpsVswitchInterfaceEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}

Параметры

[in, optional] notifyContext

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

[in] completionContext

Указатель на контекст завершения, предоставляемый драйвером выноски. Этот параметр является необязательным и может иметь значение NULL.

[in] eventType

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

[in] vSwitch

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

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

[in] vSwitchNic

Указатель на структуру NDIS_SWITCH_NIC_PARAMETERS , указывающую параметры для виртуального адаптера мини-порта, подключенного к порту виртуального коммутатора.

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

Выноска

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

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

Если параметру eventType задано значение WPS_VSWITCH_EVENT_INTERFACE_CREATE, то новое сетевое подключение между портом виртуального коммутатора и сетевым адаптером будет полностью установлено. Параметр vSwitchNic определяет структуру NDIS_SWITCH_NIC_PARAMETERS , содержащую сведения о виртуальном сетевом адаптере, подключенном к порту виртуального коммутатора.

Если параметр eventType FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT, подключение между портом виртуального коммутатора и сетевым адаптером разрывается. После полного разрыва подключения драйвер фильтра ВПП вызовет vSwitchInterfaceEventNotifyFn с FWPS_VSWITCH_EVENT_INTERFACE_DELETE, заданным в параметре eventType .

Требования

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

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

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

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS