FwpsvSwitchEventsSubscribe0, fonction (fwpsk.h)
La fonction FwpsvSwitchEventsSubscribe0 inscrit les points d’entrée de rappel pour les événements de couche de commutateur virtuel, tels que la création et la suppression de port virtuel.
Syntaxe
NTSTATUS FwpsvSwitchEventsSubscribe0(
const GUID *providerGuid,
void *notifyContext,
UINT32 flags,
void *reserved,
const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
UINT32 *subscriptionId
);
Paramètres
providerGuid
GUID du fournisseur.
notifyContext
Pointeur facultatif vers un contexte fourni par un pilote de légende. Les fonctions de notification d’événement transmettent ce paramètre au pilote.
flags
Réservé. Défini sur zéro.
reserved
Réservé. Défini sur zéro.
eventDispatchTable
Pointeur vers une structure FWPS_VSWITCH_EVENT_DISPATCH_TABLE qui définit les points d’entrée de rappel pour les événements de couche de commutateur virtuel.
subscriptionId
Pointeur vers une variable qui contient un identificateur unique attribué par PAM à l’abonnement. L’appelant doit retourner l’identificateur d’abonnement au PAM avec la fonction FwpsvSwitchEventsUnsubscribe0.
Valeur de retour
La fonction FwpsvSwitchEventsSubscribe0 retourne l’un des codes NTSTATUS suivants.
| Retourner le code | Description |
|---|---|
|
Un handle de la demande de classification a été retourné avec succès. Variable que le classifieHandle points de paramètre pour contenir le handle de la demande de classification. |
|
Une erreur s’est produite. |
Remarques
Un pilote de légende appelle la fonction FwpsvSwitchEventsSubscribe0 pour inscrire les points d’entrée de rappel pour les événements de couche de commutateur virtuel.
Les points d’entrée des fonctions de notification de rappel sont spécifiés dans et FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 structure.
Le pilote de légende doit appeler ultérieurement FwpsvSwitchEventsUnsubscribe0 pour libérer les ressources système.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Universel |
| d’en-tête | fwpsk.h (include Fwpsk.h) |
| bibliothèque | Fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |