FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

2025-02-06

Das Filtermodul ruft die vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) Legendenfunktion auf, um den Popuptreiber über das Erstellen und Löschen von Ereignissen für einen virtuellen Switch zu benachrichtigen.

HinweisFWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 ist eine bestimmte Version von FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows.

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 an den notifyContext Parameter der FwpsvSwitchEventsSubscribe0-Funktion übergeben. Dieser Parameter ist optional und kann NULL sein.

[in] eventType

Der Typ des virtuellen Switch-Ereignisses, 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 ihren aktuellen Zustand. Insbesondere können die NumSwitchPorts und IsActive--Member ihren Anfangswert 0 aufweisen, es sei denn, ein virtuelles Switch-PnP-Ereignis wurde ausgelöst. Aktuelle Statusinformationen 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 auf 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 auf einem virtuellen Switch angeschlossen ist.

Rückgabewert

Beschriftung

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Popuptreiber akzeptiert die Benachrichtigung vom Filtermodul.
Andere Statuscodes	Fehler.

Bemerkungen

Ein Popuptreiber registriert eine vSwitchLifetimeNotifyFn Rückruffunktion durch Aufrufen
die funktion FwpsvSwitchEventsSubscribe0.

Wenn der vSwitchLifetimeNotifyFn Callback registriert ist, benachrichtigt der WFP-Filtertreiber den Popuptreiber, wenn eine virtuelle Switchinstanz erstellt wird. Mehrere Instanzen eines virtuellen Switches können gleichzeitig in einem Hyper-V Host vorhanden sein.

Der WFP-Filtertreiber fragt das OID_SWITCH_PARAMETERS OID in der FilterRestart--Funktion ab, um den virtuellen Switchbezeichner abzurufen, der der aktuellen Instanz 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 NICs und virtueller Ports abzurufen. Der WFP-Filtertreiber übergibt die NDIS_SWITCH_PORT_ARRAY- und NDIS_SWITCH_NIC_ARRAY Strukturinformationen aus den OIDs an vSwitchLifetimeNotifyFn mit FWPS_VSWITCH_EVENT_VSWITCH_CREATE im eventType- Parameter festgelegt.

In der FilterDetachdes WFP-Filtertreibers werden die Filteraufrufe mit FWPS_VSWITCH_EVENT_VSWITCH_DELETE im eventTypevSwitchLifetimeNotifyFn Parameter festgelegt.

Ein Popuptreiber kann STATUS_PENDING von vSwitchLifetimeNotifyFnnicht zurückgeben.