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

  • Artículo

El motor de filtros llama a la función de llamada vSwitchInterfaceEventNotifyFn (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. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

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 al 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 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] vSwitchNic

Puntero a una estructura de NDIS_SWITCH_NIC_PARAMETERS que especifica los parámetros de un adaptador de minipuerto 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
 Se produjo un error.

Comentarios

Un controlador de llamada registra un
Función vSwitchInterfaceEventNotifyFn mediante una llamada 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, la conexión entre un puerto de conmutador virtual y un adaptador de red se está desconectando. Una vez que la conexión se ha 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 Value
Cliente mínimo compatible Disponible a partir de Windows 8.
Plataforma de destino Windows
Encabezado fwpsk.h (incluya Fwpsk.h)
IRQL <= DISPATCH_LEVEL

Consulte también

Funciones de llamada del controlador de llamada

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS