FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
08/07/2023

Die Filter-Engine ruft die Beschriftungsfunktion vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Schnittstelle des virtuellen Switches zugeordnet sind.

Beachten SieFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 eine bestimmte Version von FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK ist. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

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 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] 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 einer Legende

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung von der Filter-Engine.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber registriert eine
vSwitchInterfaceEventNotifyFn-Funktion durch Aufrufen von
die FwpsvSwitchEventsSubscribe0-Funktion .

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 hergestellt. Der Parameter vSwitchNic identifiziert eine NDIS_SWITCH_NIC_PARAMETERS-Struktur , die Informationen zum 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 abgerissen. Nachdem die Verbindung vollständig abgebrochen wurde, ruft der WFP-Filtertreiber vSwitchInterfaceEventNotifyFn auf, wobei FWPS_VSWITCH_EVENT_INTERFACE_DELETE im eventType-Parameter festgelegt ist.

Anforderungen

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

Weitere Informationen

Beschriftungsfunktionen für Den Legendentreiber

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS

Freigeben über