FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 fonction de rappel (fwpsk.h)

Article
02/06/2025

Le moteur de filtre appelle la fonction de légende vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) pour notifier un pilote de légende sur les événements de restauration d’état d’exécution du commutateur virtuel.

RemarqueFWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 est une version spécifique de FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Syntaxe

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 FwpsVswitchRuntimeStateRestoreCallback0;

NTSTATUS FwpsVswitchRuntimeStateRestoreCallback0(
  [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,
  [in]           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 Remarques.

[in] vSwitch

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

Remarque Les informations de 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 zéro, sauf si un événement PnP de commutateur virtuel a été déclenché. Les informations d’état actuelles se trouvent dans les autres paramètres de cette fonction de rappel.

[in] portId

Identificateur du port du commutateur source.

runtimeState

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

[in] runtimeStateLength

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

Valeur de retour

Légende

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 fonction retourne l’un des codes NTSTATUS suivants.

Retourner le code	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 d’état	Une erreur s’est produite.

Remarques

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

Consultez la fonction vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) pour plus d’informations sur l’enregistrement de l’état d’exécution.

Chaque segment de données enregistré est restauré avec un OID_SWITCH_NIC_RESTORE OID envoyé via les piles d’extension de commutateur virtuel sur le système cible ou sur le système local pendant une opération de restauration. LE PAM distribue les données à la légende correcte via vSwitchRuntimeStateRestoreNotifyFn après avoir correspondé à un GUID de fournisseur inscrit. Dans ce cas, le paramètre eventType de vSwitchRuntimeStateRestoreNotifyF n est défini sur FWPS_VSWITCH_EVENT_RUNTIME_STATE_RESTORE.

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