FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/29/2024

Das Filtermodul ruft die Legendenfunktion vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) auf, um einen Legendentreiber über Wiederherstellungsereignisse für den virtuellen Switch-Laufzeitzustand zu benachrichtigen.

Beachten SieFWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 eine bestimmte Version von FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK ist. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Syntax

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

Parameter

[in, optional] notifyContext

Ein Zeiger auf einen Kontext, der vom Legendentreiber bereitgestellt wird. Der Treiber hat diesen Zeiger auf den notifyContext-Parameter der Funktion FwpsvSwitchEventsSubscribe0 übergeben. Dieser Parameter ist optional und kann NULL sein.

[in] completionContext

Ein Zeiger auf einen Vervollständigungskontext, der vom Legendentreiber bereitgestellt wird. Dieser Parameter ist optional und kann NULL sein.

[in] eventType

Der Typ des virtuellen Switchereignisses, der als einer der FWPS_VSWITCH_EVENT_TYPE Enumerationswerte angegeben wird. Weitere Informationen finden Sie in den Hinweisen.

[in] vSwitch

Ein Zeiger auf eine NDIS_SWITCH_PARAMETERS Struktur, die Informationen zu einem virtuellen Switch enthält.

Hinweis Die Informationen in der NDIS_SWITCH_PARAMETERS Struktur spiegeln den Anfangszustand des virtuellen Switches wider, nicht unbedingt seinen aktuellen Zustand. Insbesondere können die NumSwitchPorts - und IsActive-Member weiterhin den Anfangswert 0 aufweisen, es sei denn, es wurde ein PnP-Ereignis für den virtuellen Switch ausgelöst. Aktuelle Zustandsinformationen finden Sie in den anderen Parametern dieser Rückruffunktion.

[in] portId

Der Portbezeichner des Quellswitches.

runtimeState

Der Speicherort des Ausgabeergebnispuffers für den Laufzeitzustand.

[in] runtimeStateLength

Die Länge der Laufzeitzustandsinformationen im Laufzeitzustandspuffer in Bytes.

Rückgabewert

Beschriftung

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung vom Filtermodul.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Legendentreiber ruft die Funktion FwpsvSwitchNotifyComplete0 auf, um den ausstehenden Vorgang abzuschließen.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber registriert eine vSwitchRuntimeStateRestoreNotifyFn-Funktion , indem er die Funktion FwpsvSwitchEventsSubscribe0 aufruft.

Informationen zum Speichern des Laufzeitzustands finden Sie in der Funktion vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0).

Jedes gespeicherte Datensegment wird mit einer OID_SWITCH_NIC_RESTORE OID wiederhergestellt, die während eines Wiederherstellungsvorgangs über die Erweiterungsstapel des virtuellen Switches auf dem Zielsystem oder auf dem lokalen System gesendet wird. WFP sendet die Daten über vSwitchRuntimeStateRestoreNotifyFn an die richtige Legende, nachdem der Abgleich mit einer registrierten Anbieter-GUID erfolgt ist. In diesem Fall wird der eventType-Parameter von vSwitchRuntimeStateRestoreNotifyFn auf FWPS_VSWITCH_EVENT_RUNTIME_STATE_RESTORE festgelegt.

Eine Legende kann STATUS_PENDING aus vSwitchRuntimeStateRestoreNotifyFn zurückgeben. In diesem Fall gibt WFP STATUS_PENDING im FilterOidRequest-Handler zurück und schließt ihn zu einem späteren Zeitpunkt ab. Der Legendentreiber ruft die Funktion FwpsvSwitchNotifyComplete0 auf, um den ausstehenden Vorgang abzuschließen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Windows
Kopfzeile	fwpsk.h (include fwpsk.h)
IRQL	<= DISPATCH_LEVEL