FN_VMB_CHANNEL_SAVE_CONTINUE funzione di callback (vmbuskernelmodeclientlibapi.h)

Articolo
02/07/2025

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce garanzie, esplicite o implicite, relativamente alle informazioni fornite qui.

La funzione VmbChannelSaveContinue salva lo stato del canale in un buffer. Eseguire il VmbChannelSaveBegin prima di eseguire questa funzione. Il driver deve controllare il valore restituito della funzione.

Sintassi

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

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

Parametri

Channel

Handle per il salvataggio di un canale.

SaveBuffer

Puntatore al buffer in cui salvare le informazioni sullo stato.

SaveBufferSize

Dimensione, in byte, del buffer di salvataggio.

BytesFilled

Puntatore a una variabile che riceve il numero di byte copiati nel buffer di salvataggio.

BytesRequired

Puntatore a una variabile che riceve il numero di byte necessari per questa funzione per eseguire lo stato di avanzamento nella chiamata successiva.

Valore restituito

VmbChannelSaveContinue restituisce i valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Lo stato è stato salvato.
STATUS_BUFFER_TOO_SMALL	Il buffer di salvataggio era troppo piccolo. Il parametro byteNeededed contiene il numero di byte necessari per eseguire qualsiasi avanzamento.
STATUS_STATUS_BUFFER_OVERFLOW	Alcuni dati sono stati scritti nel buffer di salvataggio, ma sono disponibili altri dati da salvare.

Osservazioni

Il processo di salvataggio salva i dati in "blocchi" e può continuare dal punto in cui è stato arrestato.

Se il chiamante non ha allocato spazio sufficiente in anticipo, potrebbero essere necessarie più chiamate.

Importante

Questa funzione viene chiamata tramite l'interfaccia VMBus Kernel Mode Client Library (KMCL), fornita dal driver del bus di Vmbkmcl.sys. Si tratta di una funzione solo server a cui si accede dalla struttura KMCL_SERVER_ONLY_METHODS.

Per altre informazioni, vedere la sezione Osservazioni di KMCL_SERVER_ONLY_METHODS.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1803
intestazione	vmbuskernelmodeclientlibapi.h

Vedere anche

VmbChannelSaveBegin

Condividi tramite