FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/26/2024

Die Filter-Engine ruft die Legendenfunktion vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) auf, um den Legendentreiber über das Erstellen und Löschen von Ereignissen für einen virtuellen Switch zu benachrichtigen.

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

Syntax

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 FwpsVswitchLifetimeEventCallback0;

NTSTATUS FwpsVswitchLifetimeEventCallback0(
  [in, optional] void *notifyContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_ARRAY *vSwitchPorts,
  [in, optional] const NDIS_SWITCH_NIC_ARRAY *vSwitchInterfaces
)
{...}

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] 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, optional] vSwitchPorts

Ein Zeiger auf eine NDIS_SWITCH_PORT_ARRAY-Struktur , die ein Array von Portkonfigurationsparametern angibt. Jedes Element im Array gibt die Parameter für einen Port an einem virtuellen Switch an.

[in, optional] vSwitchInterfaces

Ein Zeiger auf eine NDIS_SWITCH_NIC_ARRAY-Struktur , die ein Array von Miniportadapterkonfigurationsparametern angibt. Jedes Element im Array gibt die Parameter für einen virtuellen oder physischen Miniportadapter an, der an einen Port eines virtuellen Switches angefügt ist.

Rückgabewert

Beschriftung

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung vom Filtermodul.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber registriert eine vSwitchLifetimeNotifyFn-Rückruffunktion , indem er aufruft
die FwpsvSwitchEventsSubscribe0-Funktion .

Wenn der vSwitchLifetimeNotifyFn-Rückruf registriert ist, benachrichtigt der WFP-Filtertreiber den Legendentreiber, wenn ein virtueller Switch instance erstellt wird. Mehrere Instanzen eines virtuellen Switches können gleichzeitig in einem Hyper-V-Host vorhanden sein.

Der WFP-Filtertreiber fragt die OID_SWITCH_PARAMETERS-OID in der FilterRestart-Funktion ab, um den bezeichner des virtuellen Switches abzurufen, der dem aktuellen instance des virtuellen Switches zugeordnet ist. Der WFP-Filtertreiber fragt auch die OID_SWITCH_NIC_ARRAY und OID_SWITCH_PORT_ARRAY OIDs ab, um den anfänglichen Satz konfigurierter virtueller Netzwerkkarten und virtuellen Ports abzurufen. Der WFP-Filtertreiber übergibt die NDIS_SWITCH_PORT_ARRAY - und NDIS_SWITCH_NIC_ARRAY Strukturinformationen von den OIDs an vSwitchLifetimeNotifyFn , wobei FWPS_VSWITCH_EVENT_VSWITCH_CREATE im parameter eventType festgelegt ist.

Im FilterDetach des WFP-Filtertreibers ruft der Filter mit FWPS_VSWITCH_EVENT_VSWITCH_DELETE im parameter eventTypevSwitchLifetimeNotifyFn auf.

Ein Legendentreiber kann STATUS_PENDING von vSwitchLifetimeNotifyFn nicht zurückgeben.

Anforderungen

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