FwpsvSwitchEventsSubscribe0-Funktion (fwpsk.h)
Die FwpsvSwitchEventsSubscribe0-Funktion registriert Die Rückrufeinstiegspunkte für Ereignisse der virtuellen Switchebene, z. B. erstellung und Löschung des virtuellen Ports.
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 an den Treiber zurück.
flags
Reserviert. Auf Null festgelegt.
reserved
Reserviert. Auf Null festgelegt.
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 FwpsvSwitchEventsUnsubscribe0-Funktion an WFP zurückgeben.
Rückgabewert
Die FwpsvSwitchEventsSubscribe0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Ein Handle für die Klassifizierungsanforderung wurde erfolgreich zurückgegeben. Die Variable, auf die die klassifizierenHandle Parameter verweist, um das Handle für die Klassifizierungsanforderung zu enthalten. |
|
Fehler. |
Bemerkungen
Ein Popuptreiber 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 Popuptreiber muss später FwpsvSwitchEventsUnsubscribe0- aufrufen, um die Systemressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Zielplattform- | Universal |
| Header- | fwpsk.h (include Fwpsk.h) |
| Library | Fwpkclnt.lib |
| IRQL- | <= PASSIVE_LEVEL |