FN_VMB_CHANNEL_SAVE_CONTINUE 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 VmbChannelSaveContinue-Funktion speichert den Kanalzustand in einem Puffer. Führen Sie VmbChannelSaveBegin aus , bevor Sie diese Funktion ausführen. Der Treiber muss den Rückgabewert der Funktion überprüfen.

Syntax

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

Parameter

Channel

Ein Handle für einen zu speichernden Kanal.

SaveBuffer

Ein Zeiger auf den Puffer, in dem Zustandsinformationen gespeichert werden sollen.

SaveBufferSize

Die Größe des Speicherpuffers in Bytes.

BytesFilled

Ein Zeiger auf eine Variable, die die Anzahl der Bytes empfängt, die in den Speicherpuffer kopiert wurden.

BytesRequired

Ein Zeiger auf eine Variable, die die Anzahl von Bytes empfängt, die diese Funktion benötigt, um beim nächsten Aufruf fortschritten zu können.

Rückgabewert

VmbChannelSaveContinue gibt die folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Der Zustand wurde gespeichert.
STATUS_BUFFER_TOO_SMALL
Der Speicherpuffer war zu klein. Der BytesNeeded-Parameter enthält die Anzahl der Bytes, die für den Fortschritt erforderlich sind.
STATUS_STATUS_BUFFER_OVERFLOW
 Einige Daten wurden in den Speicherpuffer geschrieben, aber es müssen weitere Daten gespeichert werden.

Hinweise

Der Speichervorgang speichert die Daten in "Blöcken" und kann von dem Zeitpunkt an fortgesetzt werden, an dem er angehalten wurde.

Wenn der Aufrufer im Voraus nicht genügend Speicherplatz zugewiesen hat, sind möglicherweise mehrere Aufrufe erforderlich.

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

Weitere Informationen

VmbChannelSaveBegin