EVT_VMB_CHANNEL_RESTORE_PACKET Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
03/01/2024

[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 Rückruffunktion EvtVmbChannelRestorePacket wird aufgerufen, wenn der VSP-Serverendpunkt (Virtualization Service Provider) den einem Paketobjekt zugeordneten Zustand wiederherstellen muss.

Syntax

EVT_VMB_CHANNEL_RESTORE_PACKET EvtVmbChannelRestorePacket;

NTSTATUS EvtVmbChannelRestorePacket(
  [in] VMBCHANNEL Channel,
  [in] PVOID LibBuf,
  [in] UINT32 LibBufSize,
  [in] PVOID SaveBuf,
  [in] UINT32 SaveBufSize
)
{...}

Parameter

[in] Channel

Der Kanal, auf dem das Paket eingeht.

[in] LibBuf

Zeiger auf den Paketobjektstatus, der für die Kernelmodus-Clientbibliothek (KMCL) intern ist.

[in] LibBufSize

Größe des LibBuf-Parameters in Bytes.

[in] SaveBuf

Zeiger auf den VSP-spezifischen Transaktionsstatus.

[in] SaveBufSize

Größe des SaveBuf-Parameters in Bytes.

Rückgabewert

EvtVmbChannelRestorePacket gibt einen status Code zurück.

Hinweise

Die Funktion VmbServerChannelInitSetSaveRestorePacketCallbacks legt eine Rückruffunktion zum Wiederherstellen von Paketen für jeden Kanal fest.

Um ein In-Flight-Paketobjekt wiederherzustellen, muss der VSP mithilfe der VmbPacketAllocate-Funktion ein neues Paket zuordnen. Der VSP stellt das Paket in den vorherigen Zustand zurück, indem LibBuf und LibBufSize an die Funktion VmbPacketRestore übergeben werden. Wenn der VSP einen internen Zustand für die Transaktion in der Rückruffunktion EvtVmbChannelSavePacket bereitgestellt hat, wird dieser in SaveBuf bereitgestellt und vom VSP wiederhergestellt.