FN_VMB_CHANNEL_RESTORE_FROM_BUFFER Rückruffunktion (vmbuskernelmodeclientlibapi.h)

  • Artikel

[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]

Die Funktion VmbChannelRestoreFromBuffer stellt den Clientstatus aus dem zuvor gespeicherten Zustand wieder her. Der Treiber muss den Rückgabewert der Funktion überprüfen.

Syntax

FN_VMB_CHANNEL_RESTORE_FROM_BUFFER FnVmbChannelRestoreFromBuffer;

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

Parameter

Channel

Ein Handle für einen Kanal.

Buffer

Ein Zeiger auf einen Puffer, der den zuvor gespeicherten Zustand enthält.

BufferSize

Die Größe des Cookies in Bytes.

Rückgabewert

VmbChannelRestoreFromBuffer gibt einen der folgenden status Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Die Funktion wurde erfolgreich abgeschlossen.
STATUS_MORE_PROCESSING_REQUIRED
 Der Zustand wurde erfolgreich wiederhergestellt, aber weitere Blöcke wurden gespeichert.
Anderer status Code, für den NT_SUCCESS FALSE ist
 Fehler bei der Funktion.

Hinweise

Es wird erwartet, dass der Aufrufer diese Funktion mit Puffern aufruft, die ganze "Blöcke" gespeicherter Daten enthalten.

Wichtig

Diese Funktion wird über die KMCL-Schnittstelle (VmBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine reine Serverfunktion, auf die über die KMCL_SERVER_ONLY_METHODS-Struktur zugegriffen wird.

Weitere Informationen finden Sie im Abschnitt Hinweise von KMCL_SERVER_ONLY_METHODS.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1803
Kopfzeile vmbuskernelmodeclientlibapi.h