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 ports virtuels.
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 retransdent ce paramètre au pilote.
flags
Réservé. Définit la valeur zéro.
reserved
Réservé. Définit la valeur zéro.
eventDispatchTable
Pointeur vers une structure de 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 que PAM affecte à l’abonnement. L’appelant doit retourner l’identificateur d’abonnement à PAM avec la fonction FwpsvSwitchEventsUnsubscribe0 .
Valeur retournée
La fonction FwpsvSwitchEventsSubscribe0 retourne l’un des codes NTSTATUS suivants.
| Code de retour | Description |
|---|---|
|
Un handle de la demande de classification a été retourné avec succès. La variable vers laquelle pointe le paramètre classifyHandle contient le handle de la demande de classification. |
|
Une erreur est survenue. |
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 ultérieurement appeler FwpsvSwitchEventsUnsubscribe0 pour libérer les ressources système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8. |
| Plateforme cible | Universal |
| En-tête | fwpsk.h (include Fwpsk.h) |
| Bibliothèque | Fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |