Partager via


FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 fonction de rappel (fwpsk.h)

Le moteur de filtre appelle la fonction de légende vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) pour informer le pilote de légende des événements de création et de suppression d’un commutateur virtuel.

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

Syntaxe

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 FwpsVswitchLifetimeEventCallback0;

NTSTATUS FwpsVswitchLifetimeEventCallback0(
  [in, optional] void *notifyContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_ARRAY *vSwitchPorts,
  [in, optional] const NDIS_SWITCH_NIC_ARRAY *vSwitchInterfaces
)
{...}

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] 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, optional] vSwitchPorts

Pointeur vers une structure de NDIS_SWITCH_PORT_ARRAY qui spécifie un tableau de paramètres de configuration de port. Chaque élément du tableau spécifie les paramètres d’un port sur un commutateur virtuel.

[in, optional] vSwitchInterfaces

Pointeur vers une structure de NDIS_SWITCH_NIC_ARRAY qui spécifie un tableau de paramètres de configuration d’adaptateur miniport. Chaque élément du tableau spécifie les paramètres d’un adaptateur miniport virtuel ou physique attaché à un port sur un commutateur virtuel.

Valeur retournée

Une légende

FWPS_VSWITCH_LIFETIME_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 une fonction de rappel vSwitchLifetimeNotifyFn en appelant
fonction FwpsvSwitchEventsSubscribe0 .

Si le rappel vSwitchLifetimeNotifyFn est inscrit, le pilote de filtre PAM avertit le pilote de légende lorsqu’un commutateur virtuel instance est créé. Plusieurs instances d’un commutateur virtuel peuvent être présentes dans un hôte Hyper-V en même temps.

Le pilote de filtre PAM interroge l’OID OID_SWITCH_PARAMETERS dans la fonction FilterRestart pour obtenir l’identificateur de commutateur virtuel associé à la instance actuelle du commutateur virtuel. Le pilote de filtre PAM interroge également les OID_SWITCH_NIC_ARRAY et OID_SWITCH_PORT_ARRAY OID pour obtenir l’ensemble initial de cartes réseau virtuelles et de ports virtuels configurés. Le pilote de filtre PAM transmet les informations de structure NDIS_SWITCH_PORT_ARRAY et NDIS_SWITCH_NIC_ARRAY des OID à vSwitchLifetimeNotifyFn avec FWPS_VSWITCH_EVENT_VSWITCH_CREATE définie dans le paramètre eventType .

Dans le filterDetach du pilote de filtre PAM, le filtre appelle avec FWPS_VSWITCH_EVENT_VSWITCH_DELETE défini dans le paramètre eventTypevSwitchLifetimeNotifyFn .

Un pilote de légende ne peut pas retourner STATUS_PENDING de vSwitchLifetimeNotifyFn.

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

Voir aussi

Fonctions de légende du pilote de légende

FWPS_VSWITCH_EVENT_TYPE

FWPS_VSWITCH_PORT_EVENT_CALLBACK0

FilterDetach

FilterRestart

FwpsvSwitchEventsSubscribe0

FwpsvSwitchNotifyComplete0

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_PARAMETERS

NDIS_SWITCH_PORT_ARRAY

NdisFRestartComplete

OID_SWITCH_NIC_ARRAY

OID_SWITCH_PARAMETERS

OID_SWITCH_PORT_ARRAY