Condividi tramite

FN_VMB_CHANNEL_SAVE_CONTINUE funzione di callback (vmbuskernelmodeclientlibapi.h)

  • Articolo

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.

La funzione VmbChannelSaveContinue salva lo stato del canale in un buffer. Eseguire 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 BytesNeededed 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 più dati da salvare.

Commenti

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 di sola server a cui si accede dalla struttura KMCL_SERVER_ONLY_METHODS .

Per altre informazioni, vedere la sezione Osservazioni di KMCL_SERVER_ONLY_METHODS.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1803
Intestazione vmbuskernelmodeclientlibapi.h

Vedi anche

VmbChannelSaveBegin