FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 función de devolución de llamada (fwpsk.h)

Artículo
02/06/2025

El motor de filtro llama a la función de llamada de vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) para notificar al controlador de llamada acerca de los eventos de creación y eliminación de eventos para un conmutador virtual.

NotaFWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 es una versión específica de FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Sintaxis

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
)
{...}

Parámetros

[in, optional] notifyContext

Puntero a un contexto proporcionado por el controlador de llamada. El controlador pasó este puntero a la parámetro notifyContext de la función FwpsvSwitchEventsSubscribe0. Este parámetro es opcional y puede ser NULL.

[in] eventType

Tipo de evento de conmutador virtual especificado como uno de los valores de enumeración de FWPS_VSWITCH_EVENT_TYPE. Para obtener más información, vea Comentarios.

[in] vSwitch

Puntero a una estructura NDIS_SWITCH_PARAMETERS que contiene información sobre un conmutador virtual.

Nota La información de la estructura NDIS_SWITCH_PARAMETERS refleja el estado inicial del conmutador virtual, no necesariamente su estado actual. En concreto, los miembros de NumSwitchPorts y IsActive podrían seguir teniendo su valor inicial de cero, a menos que se haya desencadenado un evento PnP de conmutador virtual. La información de estado actual se puede encontrar en los demás parámetros de esta función de devolución de llamada.

[in, optional] vSwitchPorts

Puntero a una estructura de NDIS_SWITCH_PORT_ARRAY que especifica una matriz de parámetros de configuración de puerto. Cada elemento de la matriz especifica los parámetros de un puerto en un conmutador virtual.

[in, optional] vSwitchInterfaces

Puntero a una estructura NDIS_SWITCH_NIC_ARRAY que especifica una matriz de parámetros de configuración del adaptador de miniport. Cada elemento de la matriz especifica los parámetros de un adaptador de miniport virtual o físico que está conectado a un puerto en un conmutador virtual.

Valor devuelto

Una llamada

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 función devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	El controlador de llamada acepta la notificación del motor de filtro.
otros códigos de estado	Error.

Observaciones

Un controlador de llamada registra una función de devolución de llamada de vSwitchLifetimeNotifyFn mediante una llamada a
la función FwpsvSwitchEventsSubscribe0.

Si se registra el vSwitchLifetimeNotifyFn devolución de llamada, el controlador de filtro PMA notifica al controlador de llamada cuando se crea una instancia de conmutador virtual. Varias instancias de un conmutador virtual pueden estar presentes en un host de Hyper-V al mismo tiempo.

El controlador de filtro DE PMA consulta el OID_SWITCH_PARAMETERS OID en la función filterRestart para obtener el identificador del conmutador virtual asociado a la instancia actual del conmutador virtual. El controlador de filtro DE PMA también consulta los OID_SWITCH_NIC_ARRAY y OID_SWITCH_PORT_ARRAY OID para obtener el conjunto inicial de NIC virtuales y puertos virtuales configurados. El controlador de filtro PMA pasa la información de estructura NDIS_SWITCH_PORT_ARRAY y NDIS_SWITCH_NIC_ARRAY de los OID a vSwitchLifetimeNotifyFn con FWPS_VSWITCH_EVENT_VSWITCH_CREATE establecido en el parámetro eventType.

En el filterDetachdel controlador de filtro DE PMA , el filtro llama a con FWPS_VSWITCH_EVENT_VSWITCH_DELETE establecido en el parámetro eventTypevSwitchLifetimeNotifyFn.

Un controlador de llamada no puede devolver STATUS_PENDING de vSwitchLifetimeNotifyFn.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 8.
de la plataforma de destino de	Windows
encabezado de	fwpsk.h (incluya Fwpsk.h)
irQL	<= DISPATCH_LEVEL