FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/26/2024

Die Filter-Engine ruft die Legendenfunktion vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) auf, um einen Legendentreiber über Ereignisse zum Speichern des Laufzeitzustands virtueller Switches zu benachrichtigen.

Hinweis

FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 ist eine bestimmte Version von FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

Syntax

FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 FwpsVswitchRuntimeStateSaveCallback0;

NTSTATUS FwpsVswitchRuntimeStateSaveCallback0(
  [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,
  [out]          SIZE_T *runtimeStateLength
)
{...}

Parameter

[in, optional] notifyContext

Ein Zeiger auf einen Kontext, der vom Legendentreiber bereitgestellt wird. Der Treiber hat diesen Zeiger an 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, das als einer der FWPS_VSWITCH_EVENT_TYPE-Enumerationswerte angegeben ist. 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 dessen aktuellen Zustand. Insbesondere können die NumSwitchPorts - und IsActive-Member weiterhin den Anfangswert 0 (null) aufweisen, es sei denn, es wurde ein PnP-Ereignis für den virtuellen Switch ausgelöst. Informationen zum aktuellen Zustand finden Sie in den anderen Parametern dieser Rückruffunktion.

[in] portId

Der Portbezeichner des Quellswitches.

runtimeState

Der Speicherort des Ausgabeergebnispuffers für den Laufzeitzustand.

[out] runtimeStateLength

Die Länge der Laufzeitzustandsinformationen im Laufzeitzustandspuffer in Bytes.

Rückgabewert

Die FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0-Funktion einer Legende gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung von der Filter-Engine.
STATUS_PENDING	Der Vorgang ist ausstehend 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 vSwitchRuntimeStateSaveNotifyFn-Funktion , indem die Funktion FwpsvSwitchEventsSubscribe0 aufgerufen wird.

Wenn der vSwitchRuntimeStateSaveNotifyFn-Rückruf registriert ist, wird die Legende benachrichtigt, um den Laufzeitstatus einer Quell-VM abzurufen und den Laufzeitzustand einer Ziel-VM während der Livemigration oder eines lokalen Speicher- und Wiederherstellungsvorgangs wiederherzustellen. Im Speicherfall ist der eventType-Parameter von vSwitchRuntimeStateSaveNotifyFn auf FWPS_VSWITCH_EVENT_RUNTIME_STATE_SAVE festgelegt.

Der Protokolltreiber für virtuelle Switcherweiterungen gibt während eines Vorgangs eine OID-Methodenanforderung (Object Identifier) von OID_SWITCH_NIC_SAVE aus, um Laufzeitdaten für einen virtuellen Switchport zu speichern. Der Filtertreiber gibt diese Daten zurück, sodass Laufzeitdaten für einen virtuellen Switchport zu einem späteren Zeitpunkt gespeichert und wiederhergestellt werden können.

Nachdem das Laufzeitdatenblob aus allen Legenden gesammelt wurde, füllt WFP die NDIS_SWITCH_NIC_SAVE_STATE-Struktur mit den gesammelten Daten und schließt die Anforderung zum Speichern des Zustands ab.

Eine Legende kann STATUS_PENDING aus vSwitchRuntimeStateSaveNotifyFn 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.

Informationen zum Wiederherstellen des Laufzeitzustands finden Sie unter vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0).

Anforderungen

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