FWPS_VSWITCH_RUNTIME_STATE_RESTORE_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 vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) para notificar a un controlador de llamada sobre los eventos de restauración de estado de ejecución del conmutador virtual.

NotaFWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 es una versión específica de FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Sintaxis

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 FwpsVswitchRuntimeStateRestoreCallback0;

NTSTATUS FwpsVswitchRuntimeStateRestoreCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           NDIS_SWITCH_PORT_ID portId,
                 void *runtimeState,
  [in]           SIZE_T runtimeStateLength
)
{...}

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

Identificador del puerto del conmutador de origen.

runtimeState

Ubicación del búfer de resultados de salida del estado de ejecución.

[in] runtimeStateLength

Longitud, en bytes, de la información de estado en tiempo de ejecución en el búfer de estado en tiempo de ejecución.

Valor devuelto

Una llamada

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_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 vSwitchRuntimeStateRestoreNotifyFn llamando a la función FwpsvSwitchEventsSubscribe0.

Consulte la función vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) para obtener información sobre cómo guardar el estado en tiempo de ejecución.

Cada segmento de datos guardado se restaurará con un OID_SWITCH_NIC_RESTORE OID enviado a través de las pilas de extensiones del conmutador virtual en el sistema de destino o en el sistema local durante una operación de restauración. EL PMA enviará los datos a la llamada correcta a través de vSwitchRuntimeStateRestoreNotifyFn después de coincidir con un GUID de proveedor registrado. En este caso, el parámetro eventType de vSwitchRuntimeStateRestoreNotifyFn se establece en FWPS_VSWITCH_EVENT_RUNTIME_STATE_RESTORE.

Una llamada puede devolver STATUS_PENDING desde vSwitchRuntimeStateRestoreNotifyFn. En este caso, EL PMA devolverá STATUS_PENDING en el controlador de FilterOidRequest y lo completará más adelante. El controlador de llamada llamará a la función FwpsvSwitchNotifyComplete0 para completar la operación pendiente.

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