FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/07/2025

Das Filtermodul ruft die vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) Legendenfunktion auf, um den Popuptreiber über Ereignisse der virtuellen Switch-Richtlinie zu benachrichtigen.

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

Syntax

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 FwpsVswitchPolicyEventCallback0;

NTSTATUS FwpsVswitchPolicyEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_PARAMETERS *vSwitchPortProperty,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS *vSwitchPortPropertyDelete
)
{...}

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, optional] vSwitchPortProperty

Ein Zeiger auf eine NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur. Die Eigenschaft des virtuellen Switchports.

[in, optional] vSwitchPortPropertyDelete

Ein Zeiger auf eine NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS Struktur. Die Eigenschaft des virtuellen Switchports.

Rückgabewert

Beschriftung

FWPS_VSWITCH_POLICY_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 vSwitchPolicyEventNotifyFn--Funktion, indem die funktion FwpsvSwitchEventsSubscribe0 aufgerufen wird.

Wenn der vSwitchPolicyEventNotifyFn Callback registriert ist, wird die Legende auf dem Zielhost über die Richtlinie benachrichtigt, die während der Livemigration für den virtuellen Switchport konfiguriert ist, und bevor die migrierende VM auf dem neuen Host ausgeführt werden kann.

Ohne Livemigration werden vSwitchPolicyEventNotifyFn auch für einen VM-Speichervorgang aufgerufen.

Änderungen an Anbieterfilterrichtlinien, die über die VMMS-WMI-Schnittstelle konfiguriert sind, werden mit OID-Anforderungen an die WFP Virtual Switch-Erweiterung übergeben. Diese OIDs tragen eine NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur mit dem PropertyType Member auf den NdisSwitchPortPropertyTypeCustom Typ festgelegt.

Der WFP-Filtertreiber übergibt die Informationen in der OID_SWITCH_PORT_PROPERTY_ADD OID-Anforderung an vSwitchPolicyEventNotifyFn mit dem im FWPS_VSWITCH_EVENT_POLICY_ADD eventType Parameter festgelegten Typ, um Popuptreiber über das Hinzufügen einer Richtlinieneigenschaft für einen virtuellen Switchport zu benachrichtigen.

Der WFP-Filtertreiber übergibt die Informationen in der OID_SWITCH_PORT_PROPERTY_UPDATE OID-Anforderung an vSwitchPolicyEventNotifyFn mit dem im FWPS_VSWITCH_EVENT_POLICY_UPDATE eventType Parameter festgelegten Typ, um Popupfiltertreiber über das Update einer Eigenschaft für eine Richtlinie für einen virtuellen Switchport zu benachrichtigen.

Diese OIDs enthalten auch eine Eigenschafts-ID-GUID, die eindeutig identifiziert, zu welchem WFP-Anbieter die Richtlinie gehört. Die GUID des Eigenschaftenbezeichners wird bereitgestellt, wenn ein Anbieter seine Richtlinie über VMMS konfiguriert, und die GUID muss dieselbe GUID sein, die der Anbieter zum Registrieren seines Anbieters bei WFP verwendet.

WFP versucht, die Eigenschaftenbezeichner-GUID mit der Anbieter-GUID abzugleichen, die aus der FwpsvSwitchEventsSubscribe0--Funktion angegeben wurde. Wenn eine Übereinstimmung vorliegt, ruft WFP die entsprechende vSwitchPolicyEventNotifyFn- auf und übergibt die NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur an die Legende.

Der WFP-Filtertreiber übergibt die Informationen in der OID_SWITCH_PORT_PROPERTY_DELETE OID-Anforderung an vSwitchPolicyEventNotifyFn mit FWPS_VSWITCH_EVENT_POLICY_DELETE dem im eventType Parameter festgelegten Typ, um Popupfiltertreiber über das Löschen einer Richtlinieneigenschaft für einen virtuellen Switchport zu benachrichtigen. Die Löscheigenschaften werden in der NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS Struktur angegeben.

Wenn die Legende STATUS_PENDING von vSwitchPolicyEventNotifyFnzurückgibt, gibt WFP STATUS_PENDING an den FilterOidRequest--Handler zurück. Der Popuptreiber ruft den FwpsvSwitchNotifyComplete0-Funktion auf, um den ausstehenden Vorgang abzuschließen.