FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
08/07/2023

Il motore di filtro chiama la funzione callout vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) per notificare a un driver di callout gli eventi di ripristino dello stato 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 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 di 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 di callout. Questo parametro è facoltativo e può essere NULL.

[in] eventType

Tipo di evento commutatore virtuale specificato come uno dei valori di enumerazione FWPS_VSWITCH_EVENT_TYPE . Per altre informazioni, vedere la sezione 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 comunque avere il valore iniziale pari a zero, a meno che non sia stato attivato un evento PnP 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

Percorso 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

Callout

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 funzione restituisce uno dei codici NTSTATUS seguenti.

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

Commenti

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

Per informazioni sul salvataggio dello stato di runtime, vedere la funzione vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0).

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. IL WFP invierà i dati al callout corretto tramite vSwitchRuntimeStateRestoreNotifyFn dopo aver eseguito 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 FilterOidRequest e lo completerà in un secondo momento. Il driver di callout chiamerà la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Windows
Intestazione	fwpsk.h (includere Fwpsk.h)
IRQL	<= DISPATCH_LEVEL