EVT_VMB_CHANNEL_SAVE_PACKET fonction de rappel (vmbuskernelmodeclientlibapi.h)
[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 EvtVmbChannelSavePacket est appelée lorsque le point de terminaison du fournisseur de services de virtualisation (VSP) doit enregistrer l’état associé à un paquet.
Syntaxe
EVT_VMB_CHANNEL_SAVE_PACKET EvtVmbChannelSavePacket;
NTSTATUS EvtVmbChannelSavePacket(
[in] VMBCHANNEL Channel,
[in] VMBPACKET Packet,
[out] PVOID SaveBuf,
[in] UINT32 SaveBufSize,
[out] PUINT32 BytesNeeded
)
{...}
Paramètres
[in] Channel
Canal sur lequel le paquet arrive.
[in] Packet
Paquet pour lequel VSP enregistre l’état.
[out] SaveBuf
Mémoire tampon dans laquelle enregistrer l’état.
[in] SaveBufSize
Taille du paramètre SaveBuf, en octets.
[out] BytesNeeded
Taille nécessaire pour enregistrer l’état de la transaction, en octets.
Valeur de retour
EvtVmbChannelSavePacket retourne un code d’état.
Remarques
La fonction VmbServerChannelInitSetSaveRestorePacketCallbacks définit une fonction de rappel pour enregistrer des paquets pour chaque canal.
Le VSP enregistre l’état associé à la transaction qui est unique au VSP. La bibliothèque cliente en mode noyau (KMCL) enregistre son propre état.
Cette fonction est appelée pour chaque objet de paquet en cours d’utilisation. Le premier appel passe une valeur zéro (0) pour le paramètre SaveBufSize. Cet appel échoue s’il existe un état qui doit être enregistré, ce qui remplit la octetsneed avec l’exigence de taille réelle. Si ce premier appel retourne un code d’échec, la liste kmCL appelle une seconde fois avec une mémoire tampon d’au moins la longueur spécifiée dans le premier appel.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | vmbuskernelmodeclientlibapi.h (include VmbusKernelModeClientLibApi.h) |
| IRQL | PASSIVE_LEVEL |