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

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

Модуль фильтров вызывает функцию выноски 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 NumSwitchPorts и IsActive могут по-прежнему иметь начальное значение нуля, если событие PnP виртуального коммутатора не было активировано. Текущие сведения о состоянии можно найти в других параметрах этой функции обратного вызова.
 

[in] vSwitchNic

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

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

Выноска

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

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

Замечания

Драйвер выноски регистрирует
функция vSwitchInterfaceEventNotifyFn путем вызова
функция FwpsvSwitchEventsSubscribe0.

Если для параметра 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.
целевая платформа Виндоус
заголовка fwpsk.h (include Fwpsk.h)
IRQL <= DISPATCH_LEVEL

См. также

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

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS

  • Last updated on