FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 fonction de rappel (fwpsk.h)

Article
08/07/2023

Le moteur de filtre appelle la fonction de légende vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) pour informer le pilote de légende des événements de stratégie de commutateur virtuel.

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

Syntaxe

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 FwpsVswitchPolicyEventCallback0;

NTSTATUS FwpsVswitchPolicyEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_PARAMETERS *vSwitchPortProperty,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS *vSwitchPortPropertyDelete
)
{...}

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é. Les informations d’état actuel se trouvent dans les autres paramètres de cette fonction de rappel.

[in, optional] vSwitchPortProperty

Pointeur vers une structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Propriété de port de commutateur virtuel.

[in, optional] vSwitchPortPropertyDelete

Pointeur vers une structure de NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS . Propriété de port de commutateur virtuel.

Valeur retournée

Une légende

FWPS_VSWITCH_POLICY_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 vSwitchPolicyEventNotifyFn en appelant la fonction FwpsvSwitchEventsSubscribe0 .

Si le rappel vSwitchPolicyEventNotifyFn est inscrit, la légende sur l’hôte cible est informée de la stratégie configurée pour le port de commutateur virtuel pendant la migration dynamique et avant que la machine virtuelle de migration ne puisse s’exécuter sur le nouvel hôte.

Sans migration dynamique, vSwitchPolicyEventNotifyFn sera également appelé pour une opération d’enregistrement de machine virtuelle.

Les modifications apportées aux stratégies de filtrage des fournisseurs configurées via l’interface VMMS WMI sont transmises à l’extension de commutateur virtuel PAM avec des demandes OID. Ces OID portent une structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS avec le membre PropertyType défini sur le type NdisSwitchPortPropertyTypeCustom .

Le pilote de filtre PAM transmet les informations de la requête OID OID_SWITCH_PORT_PROPERTY_ADD à vSwitchPolicyEventNotifyFn avec le type FWPS_VSWITCH_EVENT_POLICY_ADD défini dans le paramètre eventType pour notifier les pilotes de légende de l’ajout d’une propriété de stratégie pour un port de commutateur virtuel.

Le pilote de filtre PAM transmet les informations contenues dans la requête OID OID_SWITCH_PORT_PROPERTY_UPDATE à vSwitchPolicyEventNotifyFn avec le type FWPS_VSWITCH_EVENT_POLICY_UPDATE défini dans le paramètre eventType pour notifier les pilotes de filtre de légende de la mise à jour d’une propriété pour une stratégie de port de commutateur virtuel.

Ces OID incluent également un GUID d’identificateur de propriété qui identifie de manière unique à quel fournisseur PAM appartient la stratégie. Le GUID d’identificateur de propriété est fourni lorsqu’un fournisseur configure sa stratégie via VMMS, et le GUID doit être le même GUID que celui utilisé par le fournisseur pour inscrire son fournisseur auprès du PAM.

PAM tente de faire correspondre le GUID d’identificateur de propriété au GUID du fournisseur spécifié à partir de la fonction FwpsvSwitchEventsSubscribe0 . S’il existe une correspondance, PAM appelle le vSwitchPolicyEventNotifyFn correspondant et transmet la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS à la légende.

Le pilote de filtre PAM transmet les informations contenues dans la requête OID OID_SWITCH_PORT_PROPERTY_DELETE à vSwitchPolicyEventNotifyFn avec le type FWPS_VSWITCH_EVENT_POLICY_DELETE défini dans le paramètre eventType pour notifier les pilotes de filtre de légende de la suppression d’une propriété de stratégie pour un port de commutateur virtuel. Les propriétés de suppression sont spécifiées dans la structure NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS .

Si la légende retourne STATUS_PENDING de vSwitchPolicyEventNotifyFn, PAM retourne STATUS_PENDING au gestionnaire FilterOidRequest . Le pilote de légende appelle la fonction FwpsvSwitchNotifyComplete0 pour terminer l’opération en attente.

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