FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/06/2025

Das Filtermodul ruft die vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) Popupfunktion auf, um den Popuptreiber über Ereignisse zu benachrichtigen, die der virtuellen Switch-Schnittstelle zugeordnet sind.

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

Syntax

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;

NTSTATUS FwpsVswitchInterfaceEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}

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] completionContext

Ein Zeiger auf einen Abschlusskontext, der vom Legendentreiber bereitgestellt wird. 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] vSwitchNic

Ein Zeiger auf eine NDIS_SWITCH_NIC_PARAMETERS-Struktur, die die Parameter für einen virtuellen Miniportadapter angibt, der mit einem virtuellen Switchport verbunden ist.

Rückgabewert

Beschriftung

FWPS_VSWITCH_INTERFACE_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 Beschriftungstreiber registriert einen
vSwitchInterfaceEventNotifyFn Funktion durch Aufrufen
die funktion FwpsvSwitchEventsSubscribe0.

Wenn der eventType Parameter auf WPS_VSWITCH_EVENT_INTERFACE_CREATE festgelegt ist, wird eine neue Netzwerkverbindung zwischen einem virtuellen Switchport und einem Netzwerkadapter vollständig eingerichtet. Der vSwitchNic Parameter identifiziert eine NDIS_SWITCH_NIC_PARAMETERS Struktur, die Informationen über den virtuellen Netzwerkadapter enthält, der mit dem virtuellen Switchport verbunden ist.

Wenn der eventType Parameter FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT ist, wird die Verbindung zwischen einem virtuellen Switchport und einem Netzwerkadapter heruntergerissen. Nachdem die Verbindung vollständig heruntergerissen wurde, ruft der WFP-Filtertreiber vSwitchInterfaceEventNotifyFn auf, wobei FWPS_VSWITCH_EVENT_INTERFACE_DELETE im parameter eventType festgelegt ist.