FwpsvSwitchEventsSubscribe0-Funktion (fwpsk.h)

Die Funktion FwpsvSwitchEventsSubscribe0 registriert Rückrufeinstiegspunkte für Ereignisse auf der Ebene virtueller Switche, z. B. erstellung und Löschen virtueller Ports.

HinweisFwpsvSwitchEventsSubscribe0 ist eine bestimmte Version von FwpsvSwitchEventsSubscribe. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

 

Syntax

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

Parameter

providerGuid

Die Anbieter-GUID.

notifyContext

Ein optionaler Zeiger auf einen vom Beschriftungstreiber bereitgestellten Kontext. Ereignisbenachrichtigungsfunktionen übergeben diesen Parameter zurück an den Treiber.

flags

Reserviert. Auf NULL festlegen.

reserved

Reserviert. Auf NULL festlegen.

eventDispatchTable

Ein Zeiger auf eine FWPS_VSWITCH_EVENT_DISPATCH_TABLE Struktur, die die Rückrufeinstiegspunkte für Ereignisse der virtuellen Switchebene definiert.

subscriptionId

Ein Zeiger auf eine Variable, die einen eindeutigen Bezeichner enthält, den WFP dem Abonnement zuweist. Der Aufrufer muss den Abonnementbezeichner mit der Funktion FwpsvSwitchEventsUnsubscribe0 an WFP zurückgeben.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Ein Handle für die Klassifizierungsanforderung wurde erfolgreich zurückgegeben. Die Variable, auf die der classifyHandle-Parameter verweist, enthält das Handle für die Klassifizierungsanforderung.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber ruft die FwpsvSwitchEventsSubscribe0-Funktion auf, um Rückrufeinstiegspunkte für Ereignisse der virtuellen Switchebene zu registrieren.

Die Einstiegspunkte für die Rückrufbenachrichtigungsfunktionen werden in und FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 Struktur angegeben.

Der Legendentreiber muss später FwpsvSwitchEventsUnsubscribe0 aufrufen, um die Systemressourcen freizugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	fwpsk.h (include Fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Weitere Informationen

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0