FN_VMB_CHANNEL_SAVE_CONTINUE Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[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 |
|---|---|
|
Der Zustand wurde gespeichert. |
|
Der Speicherpuffer war zu klein. Der BytesNeeded-Parameter enthält die Anzahl der Bytes, die für den Fortschritt erforderlich sind. |
|
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 |