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

El motor de filtro llama a la función de llamada vSwitchInteritchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) para notificar al controlador de llamada los eventos asociados a la interfaz del conmutador virtual.

NotaFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 es una versión específica de FWPS_VSWITCH_INTERFACE_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_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
)
{...}

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] completionContext

Puntero a un contexto de finalización proporcionado por el controlador de llamada. 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] vSwitchNic

Puntero a una estructura de NDIS_SWITCH_NIC_PARAMETERS que especifica los parámetros de un adaptador de miniporte virtual que está conectado a un puerto de conmutador virtual.

Valor devuelto

Una llamada

FWPS_VSWITCH_INTERFACE_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 un
función vSwitchInterfaceEventNotifyFn llamando a
la función FwpsvSwitchEventsSubscribe0.

Si el parámetro eventType se establece en WPS_VSWITCH_EVENT_INTERFACE_CREATE, se establece completamente una nueva conexión de red entre un puerto de conmutador virtual y un adaptador de red. El parámetro vSwitchNic identifica una estructura de NDIS_SWITCH_NIC_PARAMETERS que contiene información sobre el adaptador de red virtual que está conectado al puerto del conmutador virtual.

Si el parámetro eventType es FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT, se está desconectando la conexión entre un puerto de conmutador virtual y un adaptador de red. Después de que la conexión se haya roto por completo, el controlador de filtro PMA llamará a vSwitchInterfaceEventNotifyFn con FWPS_VSWITCH_EVENT_INTERFACE_DELETE establecido en el parámetro eventType.

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

Consulte también

funciones de llamada del controlador de llamada de

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS