FN_VMB_CHANNEL_SAVE_CONTINUE 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 VmbChannelSaveContinue--Funktion speichert den Kanalstatus in einem Puffer. Führen Sie die 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 der Bytes empfängt, die für diese Funktion erforderlich sind, um beim nächsten Aufruf Fortschritte zu machen.

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 parameter BytesNeededed enthält die Anzahl der Bytes, die erforderlich sind, um fortschritte zu machen.
STATUS_STATUS_BUFFER_OVERFLOW	Einige Daten wurden in den Speicherpuffer geschrieben, es müssen jedoch weitere Daten gespeichert werden.

Bemerkungen

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

Wenn der Anrufer im Voraus nicht genügend Speicherplatz zugewiesen hat, sind möglicherweise mehrere Anrufe 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 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

Siehe auch

VmbChannelSaveBegin

Freigeben über