FWPS_VSWITCH_PORT_EVENT_CALLBACK0 fonction de rappel (fwpsk.h)

Article
08/07/2023

Le moteur de filtre appelle la fonction de légende vSwitchPortEventNotifyFn (FWPS_VSWITCH_PORT_EVENT_CALLBACK0) pour informer le pilote de légende des événements associés à un port de commutateur virtuel (vSwitch).

NotezFWPS_VSWITCH_PORT_EVENT_CALLBACK0 est une version spécifique de FWPS_VSWITCH_PORT_EVENT_CALLBACK. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows .

Syntaxe

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 FwpsVswitchPortEventCallback0;

NTSTATUS FwpsVswitchPortEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_PORT_PARAMETERS *vSwitchPort
)
{...}

Paramètres

[in, optional] notifyContext

Pointeur vers un contexte fourni par le pilote de légende. Le pilote a passé ce pointeur au paramètre notifyContext de la fonction FwpsvSwitchEventsSubscribe0 . Ce paramètre est facultatif et peut être NULL.

[in] completionContext

Pointeur vers un contexte d’achèvement fourni par le pilote de légende. Ce paramètre est facultatif et peut être NULL.

[in] eventType

Type d’événement vSwitch de commutateur virtuel spécifié comme l’une des valeurs d’énumération FWPS_VSWITCH_EVENT_TYPE . Pour plus d'informations, consultez la section Notes.

[in] vSwitch

Pointeur vers une structure de NDIS_SWITCH_PARAMETERS qui contient des informations sur un commutateur virtuel.

Note Les informations contenues dans la structure NDIS_SWITCH_PARAMETERS reflètent l’état initial du commutateur virtuel, pas nécessairement son état actuel. En particulier, les membres NumSwitchPorts et IsActive peuvent toujours avoir leur valeur initiale de zéro, sauf si un événement PnP de commutateur virtuel a été déclenché. Les informations d’état actuel se trouvent dans les autres paramètres de cette fonction de rappel.

[in] vSwitchPort

Pointeur vers une structure de NDIS_SWITCH_PORT_PARAMETERS qui contient les paramètres d’un port sur un commutateur virtuel.

Valeur retournée

Une légende

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 fonction retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	Le pilote de légende accepte la notification du moteur de filtre.
STATUS_PENDING	L’opération est en attente et sera terminée ultérieurement. Le pilote de légende appelle la fonction FwpsvSwitchNotifyComplete0 pour terminer l’opération en attente.
Autres codes status	Une erreur est survenue.

Remarques

Un pilote de légende inscrit une fonction vSwitchPortEventNotifyFn en appelant la fonction FwpsvSwitchEventsSubscribe0 .

Si le rappel vSwitchPortEventNotifyFn est inscrit, le pilote de légende reçoit des notifications pour la création et la suppression du port.

Si le paramètre eventType a la valeur FWPS_VSWITCH_EVENT_PORT_CREATE, un port vSwitch a été créé. Dans ce cas, le paramètre vSwitch identifie une structure de NDIS_SWITCH_PARAMETERS qui contient des informations sur le commutateur virtuel (vSwitch) et le paramètre NDIS_SWITCH_PORT_PARAMETERS contient des informations sur le port.

Une légende peut retourner STATUS_PENDING à partir de vSwitchPortEventNotifyFn. Dans ce cas, le pilote de légende appelle la fonction FwpsvSwitchNotifyComplete0 pour terminer l’opération en attente.

Une fois le port supprimé, le pilote de filtre PAM appelle vSwitchPortEventNotifyFn avec FWPS_VSWITCH_EVENT_PORT_DELETE défini dans le paramètre eventType .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Windows
En-tête	fwpsk.h (inclure Fwpsk.h)
IRQL	<= DISPATCH_LEVEL