FwpsvSwitchEventsSubscribe0 - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// fwpsk.h
NTSTATUS FwpsvSwitchEventsSubscribe0(
const GUID *providerGuid,
void *notifyContext,
UINT32 flags,
void *reserved,
const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
UINT32 *subscriptionId
);
View the official Windows Driver Kit DDI referenceNo description available.
The FwpsvSwitchEventsSubscribe0 function registers callback entry points for virtual switch layer events such as virtual port creation and deletion.
Note FwpsvSwitchEventsSubscribe0 is a specific version of FwpsvSwitchEventsSubscribe. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.
providerGuidThe provider GUID.
notifyContextAn optional pointer to a callout driver–supplied context. Event notification functions pass this parameter back to the driver.
flagsReserved. Set to zero.
reservedReserved. Set to zero.
eventDispatchTableA pointer to an FWPS_VSWITCH_EVENT_DISPATCH_TABLE structure that defines the callback entry points for virtual switch layer events.
subscriptionIdA pointer to a variable that contains a unique identifier that WFP assigns to the subscription. The caller must return the subscription identifier to WFP with the FwpsvSwitchEventsUnsubscribe0 function.
The FwpsvSwitchEventsSubscribe0 function returns one of the following NTSTATUS codes.
| Return code | Description |
|---|---|
| STATUS_SUCCESS | A handle to the classify request was successfully returned. The variable that the classifyHandle parameter points to contains the handle for the classify request. |
| Other status codes | An error occurred. |
A callout driver calls the FwpsvSwitchEventsSubscribe0 function to register callback entry points for virtual switch layer events.
The entry points for the callback notification functions are specified in and FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 structure.
The callout driver must later call FwpsvSwitchEventsUnsubscribe0 to free the system resources.
FWPS_VSWITCH_EVENT_DISPATCH_TABLE0