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.
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 |
|---|---|
|
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. |
|
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 |