FWPS_VSWITCH_PORT_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/29/2024

Das Filtermodul ruft die Legendenfunktion vSwitchPortEventNotifyFn (FWPS_VSWITCH_PORT_EVENT_CALLBACK0) auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die einem vSwitch-Port (Virtual Switch) zugeordnet sind.

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

Syntax

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 FwpsVswitchPortEventCallback0;

NTSTATUS FwpsVswitchPortEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_PORT_PARAMETERS *vSwitchPort
)
{...}

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] 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 Switch-vSwitch-Ereignisses, das 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] vSwitchPort

Ein Zeiger auf eine NDIS_SWITCH_PORT_PARAMETERS-Struktur , die Parameter für einen Port in einem vSwitch enthält.

Rückgabewert

Beschriftung

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung vom Filtermodul.
STATUS_PENDING	Der Vorgang steht aus 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 vSwitchPortEventNotifyFn-Funktion , indem die Funktion FwpsvSwitchEventsSubscribe0 aufgerufen wird.

Wenn der vSwitchPortEventNotifyFn-Rückruf registriert ist, empfängt der Legendentreiber Benachrichtigungen zum Erstellen und Löschen des Ports.

Wenn der eventType-Parameter auf FWPS_VSWITCH_EVENT_PORT_CREATE festgelegt ist, wurde ein vSwitch-Port erstellt. In diesem Fall identifiziert der vSwitch-Parameter eine NDIS_SWITCH_PARAMETERS Struktur, die Informationen über den virtuellen Switch (vSwitch) enthält, und der parameter NDIS_SWITCH_PORT_PARAMETERS enthält Informationen zum Port.

Eine Legende kann STATUS_PENDING von vSwitchPortEventNotifyFn zurückgeben. In diesem Fall ruft der Legendentreiber die Funktion FwpsvSwitchNotifyComplete0 auf, um den ausstehenden Vorgang abzuschließen.

Nachdem der Port gelöscht wurde, ruft der WFP-Filtertreiber vSwitchPortEventNotifyFn mit FWPS_VSWITCH_EVENT_PORT_DELETE im eventType-Parameter auf.

Anforderungen

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