FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS função de retorno de chamada (vmbuskernelmodeclientlibapi.h)

Artigo
02/26/2024

A função VmbServerChannelInitSetSaveRestorePacketCallbacks define as funções de retorno de chamada de salvamento e restauração que são chamadas para cada pacote quando o driver chama uma função save, como VmbChannelSaveBegin, VmbChannelSaveContinue e VmbChannelSaveEnd ou a função VmbChannelRestoreFromBuffer .

Sintaxe

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
)
{...}

Parâmetros

Channel

Um identificador para um canal.

SavePacketCallback

Uma função de retorno de chamada a ser chamada durante o salvamento do canal.

RestorePacketCallback

Uma função de retorno de chamada a ser chamada durante a restauração do canal.

Retornar valor

VmbServerChannelInitSetSaveRestorePacketCallbacks retorna os seguintes valores de status:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER_1	O valor canal era inválido ou em um estado inválido, como Desabilitado.

Comentários

Importante

Essa função é chamada por meio da interface KMCL (Biblioteca de Clientes do Modo Kernel do VMBus), fornecida pelo driver de barramento Vmbkmcl.sys. Essa é uma função somente de servidor acessada da estrutura KMCL_SERVER_ONLY_METHODS .

Para obter mais informações, consulte a seção Comentários do KMCL_SERVER_ONLY_METHODS.