FN_VMB_CHANNEL_RESTORE_FROM_BUFFER Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
02/07/2025

[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.]

Die VmbChannelRestoreFromBuffer Funktion 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 Puffers in Bytes.

Rückgabewert

VmbChannelRestoreFromBuffer gibt einen der folgenden Statuswerte 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 Statuscode, für den NT_SUCCESS FALSE	Fehler bei der Funktion.

Bemerkungen

Der Aufrufer wird erwartet, dass diese Funktion mit Puffern aufgerufen wird, 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 servergeschützte Funktion, 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
mindestens unterstützte Client-	Windows 10, Version 1803
Header-	vmbuskernelmodeclientlibapi.h

Freigeben über