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

Artículo
08/07/2023

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

NotaFWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 es una versión específica de FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

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 al 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 la sección Comentarios.

[in] vSwitch

Puntero a una estructura de 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 NumSwitchPorts e IsActive pueden 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 de NDIS_SWITCH_NIC_ARRAY que especifica una matriz de parámetros de configuración del adaptador de minipuerto. Cada elemento de la matriz especifica los parámetros de un adaptador de minipuerto 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	Se produjo un error.

Comentarios

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

Si se registra la devolución de llamada vSwitchLifetimeNotifyFn , el controlador de filtro DE 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 las 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 DE 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 filterDetach del 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	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.
Plataforma de destino	Windows
Encabezado	fwpsk.h (incluya Fwpsk.h)
IRQL	<= DISPATCH_LEVEL