FN_VMB_CHANNEL_SAVE_CONTINUE fonction de rappel (vmbuskernelmodeclientlibapi.h)

Article
02/26/2024

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

La fonction VmbChannelSaveContinue enregistre l’état du canal dans une mémoire tampon. Exécutez VmbChannelSaveBegin avant d’exécuter cette fonction. Le pilote doit case activée 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 pour 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 copiés dans la mémoire tampon d’enregistrement.

BytesRequired

Pointeur vers une variable qui reçoit le nombre d’octets nécessaires pour que cette fonction progresse lors de l’appel suivant.

Valeur retournée

VmbChannelSaveContinue retourne les valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	L’état a été enregistré.
STATUS_BUFFER_TOO_SMALL	La mémoire tampon d’enregistrement était trop petite. Le paramètre BytesNeeded contient le nombre d’octets requis pour effectuer toute progression.
STATUS_STATUS_BUFFER_OVERFLOW	Certaines données ont été écrites dans la mémoire tampon d’enregistrement, mais il y a d’autres données à enregistrer.

Remarques

Le processus d’enregistrement enregistre les données en « blocs » et peut continuer à partir du point où ils se sont arrêtés.

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 (Kernel Mode Client Library) VMBus, 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	vmbuskernelmodeclientlibapi.h

Voir aussi

VmbChannelSaveBegin

Partager via