FN_VMB_CHANNEL_SAVE_CONTINUE 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 VmbChannelSaveContinue enregistre l’état du canal dans une mémoire tampon. Exécutez la VmbChannelSaveBegin avant d’exécuter cette fonction. Le pilote doit vérifier la valeur de retour de la fonction.

Syntaxe

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

Paramètres

Channel

Handle d’un canal à enregistrer.

SaveBuffer

Pointeur vers la mémoire tampon dans laquelle enregistrer les informations d’état.

SaveBufferSize

Taille, en octets, de la mémoire tampon d’enregistrement.

BytesFilled

Pointeur vers une variable qui reçoit le nombre d’octets qui ont été copiés dans la mémoire tampon d’enregistrement.

BytesRequired

Pointeur vers une variable qui reçoit le nombre d’octets nécessaires à cette fonction pour faire progresser l’appel suivant.

Valeur de retour

VmbChannelSaveContinue retourne les valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	L’état a été enregistré.
STATUS_BUFFER_TOO_SMALL	La mémoire tampon d’enregistrement était trop petite. Le paramètre BytesNeededed contient le nombre d’octets requis pour progresser.
STATUS_STATUS_BUFFER_OVERFLOW	Certaines données ont été écrites dans la mémoire tampon d’enregistrement, mais il y a plus de données à enregistrer.

Remarques

Le processus d’enregistrement enregistre les données en « blocs » et peut continuer à partir du point qu’il a arrêté.

Si l’appelant n’a pas alloué suffisamment d’espace à l’avance, plusieurs appels peuvent être nécessaires.

Important

Cette fonction est appelée par le biais de l’interface KMCL (VmBus Kernel Mode Client Library), fournie par le pilote de bus Vmbkmcl.sys. Il s’agit d’une fonction serveur uniquement accessible à partir de la structure KMCL_SERVER_ONLY_METHODS.

Pour plus d’informations, consultez la section Remarques de KMCL_SERVER_ONLY_METHODS.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1803
d’en-tête	vmbuskernelmodeclientlibapi.h

Voir aussi

VmbChannelSaveBegin