FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 fonction de rappel (fwpsk.h)

Article
08/07/2023

Le moteur de filtre appelle la fonction de légende vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) pour informer un pilote de légende des événements d’enregistrement de l’état d’exécution du commutateur virtuel.

Notes

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

Syntaxe

FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 FwpsVswitchRuntimeStateSaveCallback0;

NTSTATUS FwpsVswitchRuntimeStateSaveCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           NDIS_SWITCH_PORT_ID portId,
                 void **runtimeState,
  [out]          SIZE_T *runtimeStateLength
)
{...}

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.

Notes

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] portId

Identificateur de port du commutateur source.

runtimeState

Emplacement de la mémoire tampon de résultat de sortie de l’état d’exécution.

[out] runtimeStateLength

Longueur, en octets, des informations d’état d’exécution dans la mémoire tampon d’état d’exécution.

Valeur retournée

La fonction FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 d’une légende 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 vSwitchRuntimeStateSaveNotifyFn en appelant la fonction FwpsvSwitchEventsSubscribe0 .

Si le rappel vSwitchRuntimeStateSaveNotifyFn est inscrit, la légende est avertie de récupérer l’état d’exécution d’une machine virtuelle source et de restaurer l’état d’exécution d’une machine virtuelle cible pendant la migration dynamique ou une opération locale d’enregistrement et de restauration. Dans le cas d’enregistrement, le paramètre eventType de vSwitchRuntimeStateSaveNotifyFn est défini sur FWPS_VSWITCH_EVENT_RUNTIME_STATE_SAVE.

Le pilote de protocole d’extension de commutateur virtuel émet une demande de méthode d’identificateur d’objet (OID) de OID_SWITCH_NIC_SAVE au cours d’une opération afin d’économiser les données d’exécution d’un port de commutateur virtuel. Le pilote de filtre retourne ces données afin que les données d’exécution d’un port de commutateur virtuel puissent être enregistrées et restaurées ultérieurement.

Une fois l’objet blob de données d’exécution de toutes les légendes collecté, PAM remplit la structure NDIS_SWITCH_NIC_SAVE_STATE avec les données collectées et termine la demande d’enregistrement d’état.

Une légende peut retourner STATUS_PENDING à partir de vSwitchRuntimeStateSaveNotifyFn. Dans ce cas, PAM retourne STATUS_PENDING dans le gestionnaire FilterOidRequest et la termine ultérieurement. Le pilote de légende appelle la fonction FwpsvSwitchNotifyComplete0 pour terminer l’opération en attente.

Pour plus d’informations sur la restauration de l’état d’exécution, consultez la fonction vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0).

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