EVT_VMB_CHANNEL_RESTORE_PACKET fonction de rappel (vmbuskernelmodeclientlibapi.h)

Article
02/07/2025

[Certaines informations concernent le produit préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.]

La fonction de rappel EvtVmbChannelRestorePacket est appelée lorsque le point de terminaison de serveur du fournisseur de services de virtualisation (VSP) doit restaurer l’état associé à un objet de paquet.

Syntaxe

EVT_VMB_CHANNEL_RESTORE_PACKET EvtVmbChannelRestorePacket;

NTSTATUS EvtVmbChannelRestorePacket(
  [in] VMBCHANNEL Channel,
  [in] PVOID LibBuf,
  [in] UINT32 LibBufSize,
  [in] PVOID SaveBuf,
  [in] UINT32 SaveBufSize
)
{...}

Paramètres

[in] Channel

Canal sur lequel le paquet arrive.

[in] LibBuf

Pointeur vers l’état de l’objet de paquet interne à la bibliothèque cliente en mode noyau (KMCL).

[in] LibBufSize

Taille du paramètre LibBuf, en octets.

[in] SaveBuf

Pointeur vers l’état de transaction spécifique au VSP.

[in] SaveBufSize

Taille du paramètre SaveBuf, en octets.

Valeur de retour

EvtVmbChannelRestorePacket retourne un code d’état.

Remarques

La fonction VmbServerChannelInitSetSaveRestorePacketCallbacks définit une fonction de rappel pour la restauration des paquets pour chaque canal.

Pour restaurer un objet de paquet en version d’évaluation, le fournisseur de services virtuels doit allouer un nouveau paquet à l’aide de la fonction VmbPacketAllocate. Le VSP restaure le paquet à l’état précédent en passant LibBuf et LibBufSize à la fonction VmbPacketRestore. Si le VSP a fourni un état interne pour la transaction dans la fonction de rappel EvtVmbChannelSavePacket, cela est fourni dans SaveBufet restauré par le VSP.