FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
02/07/2025

Die VmbServerChannelInitSetSaveRestorePacketCallbacks Funktion legt die Speicher- und Wiederherstellungsrückruffunktionen fest, die für jedes Paket aufgerufen werden, wenn der Treiber eine Speicherfunktion aufruft, wie VmbChannelSaveBegin, VmbChannelSaveContinueund VmbChannelSaveEnd, oder die VmbChannelRestoreFromBuffer Funktion.

Syntax

FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS FnVmbServerChannelInitSetSaveRestorePacketCallbacks;

NTSTATUS FnVmbServerChannelInitSetSaveRestorePacketCallbacks(
  VMBCHANNEL Channel,
  PFN_VMB_CHANNEL_SAVE_PACKET SavePacketCallback,
  PFN_VMB_CHANNEL_RESTORE_PACKET RestorePacketCallback
)
{...}

Parameter

Channel

Ein Handle für einen Kanal.

SavePacketCallback

Eine Rückruffunktion, die beim Speichern des Kanals aufgerufen werden soll.

RestorePacketCallback

Eine Rückruffunktion, die während der Kanalwiederherstellung aufgerufen werden soll.

Rückgabewert

VmbServerChannelInitSetSaveRestorePacketCallbacks gibt die folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER_1	Der Channel- Wert war ungültig oder in einem ungültigen Zustand, z. B. "Deaktiviert".

Bemerkungen

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.