FWPS_VSWITCH_PORT_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/07/2025

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

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

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 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 vSwitch-Ereignisses des virtuellen Switches, der 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] vSwitchPort

Ein Zeiger auf eine NDIS_SWITCH_PORT_PARAMETERS Struktur, die Parameter für einen Port auf 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 Popuptreiber akzeptiert die Benachrichtigung vom Filtermodul.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Popuptreiber ruft den FwpsvSwitchNotifyComplete0-Funktion auf, um den ausstehenden Vorgang abzuschließen.
Andere Statuscodes	Fehler.

Bemerkungen

Ein Popuptreiber registriert eine vSwitchPortEventNotifyFn- Funktion, indem die FwpsvSwitchEventsSubscribe0-Funktion aufgerufen wird.

Wenn der vSwitchPortEventNotifyFn Callback registriert ist, empfängt der Popuptreiber Benachrichtigungen für die Porterstellung und -löschung.

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 NDIS_SWITCH_PORT_PARAMETERS Parameter Informationen zum Port enthält.

Eine Legende kann STATUS_PENDING von vSwitchPortEventNotifyFnzurückgeben. In diesem Fall ruft der Popuptreiber den FwpsvSwitchNotifyComplete0-Funktion auf, um den ausstehenden Vorgang abzuschließen.

Nachdem der Port gelöscht wurde, ruft der WFP-Filtertreiber vSwitchPortEventNotifyFn auf, wobei FWPS_VSWITCH_EVENT_PORT_DELETE im parameter eventType festgelegt ist.