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

Artículo
08/07/2023

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

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

Identificador del puerto del conmutador de origen.

runtimeState

Ubicación del búfer de resultados de salida de estado en tiempo 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	Se produjo un error.

Comentarios

Un controlador de llamada registra una función vSwitchRuntimeStateRestoreNotifyFn mediante una llamada 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 de OID_SWITCH_NIC_RESTORE enviado a través de las pilas de extensiones de 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 del 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 de vSwitchRuntimeStateRestoreNotifyFn. En este caso, EL PMA devolverá STATUS_PENDING en el controlador 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	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.
Plataforma de destino	Windows
Encabezado	fwpsk.h (incluya Fwpsk.h)
IRQL	<= DISPATCH_LEVEL