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

  • Artigo

[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]

A função de retorno de chamada EvtVmbChannelSavePacket é invocada quando o ponto de extremidade do VSP (provedor de serviços de virtualização) deve salvar o estado associado a um pacote.

Sintaxe

EVT_VMB_CHANNEL_SAVE_PACKET EvtVmbChannelSavePacket;

NTSTATUS EvtVmbChannelSavePacket(
  [in]  VMBCHANNEL Channel,
  [in]  VMBPACKET Packet,
  [out] PVOID SaveBuf,
  [in]  UINT32 SaveBufSize,
  [out] PUINT32 BytesNeeded
)
{...}

Parâmetros

[in] Channel

O canal no qual o pacote chega.

[in] Packet

O pacote para o qual o VSP salva o estado.

[out] SaveBuf

O buffer no qual salvar o estado.

[in] SaveBufSize

Tamanho do parâmetro SaveBuf , em bytes.

[out] BytesNeeded

Tamanho necessário para salvar o estado da transação, em bytes.

Retornar valor

EvtVmbChannelSavePacket retorna um código status.

Comentários

A função VmbServerChannelInitSetSaveRestorePacketCallbacks define uma função de retorno de chamada para salvar pacotes para cada canal.

O VSP salva o estado associado à transação exclusiva do VSP. A KMCL (Biblioteca de Clientes do Modo Kernel) salva seu próprio estado.

Essa função é invocada para cada objeto de pacote que está em uso no momento. A primeira invocação passa um valor zero (0) para o parâmetro SaveBufSize . Essa chamada falhará se houver algum estado que precise ser salvo, que preencha BytesNeeded com o requisito de tamanho real. Se essa primeira invocação retornar um código de falha, o KMCL chamará uma segunda vez com um buffer de pelo menos o comprimento estipulado na primeira chamada.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho vmbuskernelmodeclientlibapi.h (inclua VmbusKernelModeClientLibApi.h)
IRQL PASSIVE_LEVEL

Confira também

VmbServerChannelInitSetSaveRestorePacketCallbacks