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

Статья
02/07/2025

Подсистема фильтрации вызывает функцию выноски vSwitchPortEventNotifyFn (FWPS_VSWITCH_PORT_EVENT_CALLBACK0) для уведомления драйвера выноски о событиях, связанных с портом виртуального коммутатора (vSwitch).

ПримечаниеFWPS_VSWITCH_PORT_EVENT_CALLBACK0 — это определенная версия FWPS_VSWITCH_PORT_EVENT_CALLBACK. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Синтаксис

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 FwpsVswitchPortEventCallback0;

NTSTATUS FwpsVswitchPortEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_PORT_PARAMETERS *vSwitchPort
)
{...}

Параметры

[in, optional] notifyContext

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

[in] completionContext

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

[in] eventType

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

[in] vSwitch

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

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

[in] vSwitchPort

Указатель на NDIS_SWITCH_PORT_PARAMETERS структуру, содержащую параметры порта в vSwitch.

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

Выноска

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

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

Замечания

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

Если зарегистрирован обратный вызов vSwitchPortEventNotifyFn, драйвер выноски получает уведомления о создании и удалении портов.

Если параметр eventType имеет значение FWPS_VSWITCH_EVENT_PORT_CREATE, был создан порт vSwitch. В этом случае параметр vSwitch определяет структуру NDIS_SWITCH_PARAMETERS, содержащую сведения о виртуальном коммутаторе (vSwitch), а параметр NDIS_SWITCH_PORT_PARAMETERS содержит сведения о порту.

Выноска может возвращать STATUS_PENDING из vSwitchPortEventNotifyFn. В этом случае драйвер выноски вызывает функцию FwpsvSwitchNotifyComplete0 для завершения ожидающей операции.

После удаления порта драйвер фильтра МПП вызывает vSwitchPortEventNotifyFn с FWPS_VSWITCH_EVENT_PORT_DELETE, заданным в параметре eventType.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.
целевая платформа	Виндоус
заголовка	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL