FWPS_VSWITCH_PORT_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 vSwitchPortEventNotifyFn (FWPS_VSWITCH_PORT_EVENT_CALLBACK0) para notificar al controlador de llamada los eventos asociados a un puerto de conmutador virtual (vSwitch).

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

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 vSwitch del 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] vSwitchPort

Puntero a una estructura de NDIS_SWITCH_PORT_PARAMETERS que contiene parámetros para un puerto en un vSwitch.

Valor devuelto

Una llamada

FWPS_VSWITCH_PORT_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.
STATUS_PENDING	La operación está pendiente y se completará más adelante. El controlador de llamada llamará a la función FwpsvSwitchNotifyComplete0 para completar la operación pendiente.
otros códigos de estado	Error.

Observaciones

Un controlador de llamada registra una función de vSwitchPortEventNotifyFn llamando a la función FwpsvSwitchEventsSubscribe0.

Si se registra el vSwitchPortEventNotifyFn devolución de llamada, el controlador de llamada recibe notificaciones para la creación y eliminación del puerto.

Si el parámetro eventType se establece en FWPS_VSWITCH_EVENT_PORT_CREATE, se creó un puerto vSwitch. En este caso, el parámetro vSwitch identifica una estructura NDIS_SWITCH_PARAMETERS que contiene información sobre el conmutador virtual (vSwitch) y el parámetro NDIS_SWITCH_PORT_PARAMETERS contiene información sobre el puerto.

Una llamada puede devolver STATUS_PENDING de vSwitchPortEventNotifyFn. En este caso, el controlador de llamada llama a la función FwpsvSwitchNotifyComplete0 para completar la operación pendiente.

Una vez eliminado el puerto, el controlador de filtro DEL PMA llama vSwitchPortEventNotifyFn con FWPS_VSWITCH_EVENT_PORT_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