FWPS_VSWITCH_PORT_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 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. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

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 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 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 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] 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	Se produjo un error.

Comentarios

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

Si se registra la devolución de llamada vSwitchPortEventNotifyFn , 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 de 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 DE PMA llama a vSwitchPortEventNotifyFn con FWPS_VSWITCH_EVENT_PORT_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