FN_VMB_CHANNEL_RESTORE_FROM_BUFFER funzione di callback (vmbuskernelmodeclientlibapi.h)

[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 VmbChannelRestoreFromBuffer ripristina lo stato del client dallo stato salvato in precedenza. Il driver deve controllare il valore restituito della funzione.

Sintassi

FN_VMB_CHANNEL_RESTORE_FROM_BUFFER FnVmbChannelRestoreFromBuffer;

NTSTATUS FnVmbChannelRestoreFromBuffer(
  VMBCHANNEL Channel,
  PVOID Buffer,
  ULONG BufferSize
)
{...}

Parametri

Channel

Handle per un canale.

Buffer

Puntatore a un buffer contenente lo stato salvato in precedenza.

BufferSize

Dimensione, in byte, del buffer.

Valore restituito

VmbChannelRestoreFromBuffer restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione è stata completata correttamente.
STATUS_MORE_PROCESSING_REQUIRED	Lo stato è stato ripristinato correttamente, ma sono stati salvati più blocchi.
Altro codice di stato per il quale NT_SUCCESS è FALSE	La funzione non è riuscita.

Osservazioni

Il chiamante dovrebbe chiamare questa funzione con buffer che contengono interi "blocchi" di dati archiviati.

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