FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// vmbuskernelmodeclientlibapi.h

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
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-vmbuskernelmodeclientlibapi-fn_vmb_server_channel_init_set_save_restore_packet_callbacks)

FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS callback function

Description

The VmbServerChannelInitSetSaveRestorePacketCallbacks function sets the save and restore callback functions that are called for each packet when the driver calls a save function, such as VmbChannelSaveBegin, VmbChannelSaveContinue, and VmbChannelSaveEnd, or the VmbChannelRestoreFromBuffer function.

Parameters

Channel

A handle for a channel.

SavePacketCallback

A callback function to call during channel save.

RestorePacketCallback

A callback function to call during channel restore.

Return value

VmbServerChannelInitSetSaveRestorePacketCallbacks returns the following status values:

Return code Description
STATUS_INVALID_PARAMETER_1 The Channel value was invalid or in an invalid state, such as Disabled.

Prototype

//Declaration

FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS FnVmbServerChannelInitSetSaveRestorePacketCallbacks;

// Definition

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

Remarks

[!IMPORTANT] This function is called through the VMBus Kernel Mode Client Library (KMCL) interface, provided by the Vmbkmcl.sys bus driver. This is a server-only function accessed from the KMCL_SERVER_ONLY_METHODS structure.

For more information, see the Remarks section of KMCL_SERVER_ONLY_METHODS.

See also

VmbChannelRestoreFromBuffer

VmbChannelSaveBegin

VmbChannelSaveContinue

VmbChannelSaveEnd