FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
02/06/2025

Il motore di filtro chiama la funzione callout vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) per notificare a un driver callout gli eventi di ripristino dello stato di runtime del commutatore virtuale.

NotaFWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 è una versione specifica di FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

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
)
{...}

Parametri

[in, optional] notifyContext

Puntatore a un contesto fornito dal driver del callout. Il driver ha passato questo puntatore al parametro notifyContext della funzione fwpsvSwitchEventsSubscribe0. Questo parametro è facoltativo e può essere NULL.

[in] completionContext

Puntatore a un contesto di completamento fornito dal driver del callout. Questo parametro è facoltativo e può essere NULL.

[in] eventType

Tipo di evento del commutatore virtuale specificato come uno dei valori di enumerazione FWPS_VSWITCH_EVENT_TYPE. Per altre informazioni, vedere Osservazioni.

[in] vSwitch

Puntatore a una struttura NDIS_SWITCH_PARAMETERS che contiene informazioni su un commutatore virtuale.

Nota Le informazioni nella struttura NDIS_SWITCH_PARAMETERS riflettono lo stato iniziale del commutatore virtuale, non necessariamente lo stato corrente. In particolare, i membri NumSwitchPorts e IsActive potrebbero avere il valore iniziale pari a zero, a meno che non sia stato attivato un evento PnP del commutatore virtuale. Le informazioni sullo stato corrente sono disponibili negli altri parametri di questa funzione di callback.

[in] portId

Identificatore della porta del commutatore di origine.

runtimeState

Posizione del buffer dei risultati dell'output dello stato di runtime.

[in] runtimeStateLength

Lunghezza, in byte, delle informazioni sullo stato di runtime nel buffer dello stato di runtime.

Valore restituito

Un callout

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 funzione restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il driver callout accetta la notifica dal motore di filtro.
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il driver callout chiamerà la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Un driver callout registra una funzione vSwitchRuntimeStateRestoreNotifyFn chiamando la funzione FwpsvSwitchEventsSubscribe0.

Vedere la funzione vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) per informazioni sul salvataggio dello stato di runtime.

Ogni segmento di dati salvato verrà ripristinato con un OID OID_SWITCH_NIC_RESTORE inviato tramite gli stack di estensioni del commutatore virtuale nel sistema di destinazione o nel sistema locale durante un'operazione di ripristino. WFP invierà i dati al callout corretto tramite vSwitchRuntimeStateRestoreNotifyFn dopo la corrispondenza con un GUID del provider registrato. In questo caso, il parametro eventType di vSwitchRuntimeStateRestoreNotifyFn è impostato su FWPS_VSWITCH_EVENT_RUNTIME_STATE_RESTORE.

Un callout può restituire STATUS_PENDING da vSwitchRuntimeStateRestoreNotifyFn. In questo caso, il WFP restituirà STATUS_PENDING nel gestore FilterOidRequestRequest e lo completerà in un secondo momento. Il driver callout chiamerà la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Finestre
intestazione	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL