FN_VMB_CHANNEL_RESTORE_FROM_BUFFER funzione di callback (vmbuskernelmodeclientlibapi.h)

Articolo
02/29/2024

[Alcune informazioni si riferiscono al prodotto pre-rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non offre garanzie, esplicite o implicite, rispetto 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 del buffer, in byte.

Valore restituito

VmbChannelRestoreFromBuffer restituisce uno dei valori di stato seguenti:

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

Commenti

Il chiamante deve 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 di sola server a cui è stato eseguito l'accesso 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

Condividi tramite