FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/27/2024

Das Filtermodul ruft die vSwitchPolicyEventNotifyFn-Funktion (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) auf, um den Legendentreiber über Virtuelle Switch-Richtlinienereignisse zu benachrichtigen.

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

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

Ein Zeiger auf eine NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur . Die Porteigenschaft des virtuellen Switches.

[in, optional] vSwitchPortPropertyDelete

Ein Zeiger auf eine NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS-Struktur . Die Porteigenschaft des virtuellen Switches.

Rückgabewert

Beschriftung

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

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

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

Änderungen an Anbieterfilterrichtlinien, die über die VMMS-WMI-Schnittstelle konfiguriert werden, werden mit OID-Anforderungen an die WFP-Erweiterung für virtuelle Switches übergeben. Diese OIDs enthalten eine NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur , wobei das PropertyType-Element auf den Typ NdisSwitchPortPropertyTypeCustom festgelegt ist.

Der WFP-Filtertreiber übergibt die Informationen in der OID_SWITCH_PORT_PROPERTY_ADD OID-Anforderung an vSwitchPolicyEventNotifyFn mit dem im eventType-Parameter festgelegten FWPS_VSWITCH_EVENT_POLICY_ADD Typ, um Legendentreiber ü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 , wobei der FWPS_VSWITCH_EVENT_POLICY_UPDATE Typ im eventType-Parameter festgelegt ist, um Legendenfiltertreiber über die Aktualisierung einer Eigenschaft für eine Portrichtlinie für virtuelle Switches zu benachrichtigen.

Diese OIDs enthalten auch eine Eigenschaftenbezeichner-GUID, die eindeutig identifiziert, zu welchem WFP-Anbieter die Richtlinie gehört. Die EIGENSCHAFTENbezeichner-GUID wird bereitgestellt, wenn ein Anbieter seine Richtlinie über VMMS konfiguriert, und die GUID muss dieselbe GUID sein, die der Anbieter verwendet, um seinen Anbieter bei WFP zu registrieren.

WFP versucht, die GUID der Eigenschaftenbezeichner-GUID zuzuordnen, die in der Funktion FwpsvSwitchEventsSubscribe0 angegeben ist. Wenn eine Übereinstimmung vorhanden ist, 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 , wobei der FWPS_VSWITCH_EVENT_POLICY_DELETE Typ im eventType-Parameter festgelegt ist, um Legendenfiltertreiber über das Löschen einer Richtlinieneigenschaft für einen virtuellen Switchport zu benachrichtigen. Die Delete-Eigenschaften werden in der NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS-Struktur angegeben.

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

Anforderungen

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