FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 fonction de rappel (fwpsk.h)

Article
02/26/2024

Le moteur de filtre appelle la fonction de légende vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) pour informer le pilote de légende des événements associés à l’interface de commutateur virtuel.

NotezFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 est une version spécifique de FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Syntaxe

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;

NTSTATUS FwpsVswitchInterfaceEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}

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 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é. Vous trouverez des informations sur l’état actuel dans les autres paramètres de cette fonction de rappel.

[in] vSwitchNic

Pointeur vers une structure NDIS_SWITCH_NIC_PARAMETERS qui spécifie les paramètres d’un adaptateur miniport virtuel connecté à un port de commutateur virtuel.

Valeur retournée

Une légende

FWPS_VSWITCH_INTERFACE_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.
Autres codes status	Une erreur est survenue.

Remarques

Un pilote de légende inscrit un
Fonction vSwitchInterfaceEventNotifyFn en appelant
fonction FwpsvSwitchEventsSubscribe0 .

Si le paramètre eventType est défini sur WPS_VSWITCH_EVENT_INTERFACE_CREATE, une nouvelle connexion réseau entre un port de commutateur virtuel et une carte réseau est complètement établie. Le paramètre vSwitchNic identifie une structure de NDIS_SWITCH_NIC_PARAMETERS qui contient des informations sur la carte réseau virtuelle connectée au port du commutateur virtuel.

Si le paramètre eventType est FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT, la connexion entre un port de commutateur virtuel et une carte réseau est en cours d’arrêt. Une fois la connexion complètement supprimée, le pilote de filtre PAM appelle vSwitchInterfaceEventNotifyFn avec FWPS_VSWITCH_EVENT_INTERFACE_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 (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL