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

Artigo
02/07/2025

[Algumas informações referem-se ao produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não faz garantias, expressas ou implícitas, em relação às informações fornecidas aqui.]

A função VmbChannelSaveContinue salva o estado do canal em um buffer. Execute o VmbChannelSaveBegin antes de executar essa função. O driver deve verificar o valor retornado da função.

Sintaxe

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

Parâmetros

Channel

Um identificador para um canal a ser salvo.

SaveBuffer

Um ponteiro para o buffer no qual salvar informações de estado.

SaveBufferSize

O tamanho, em bytes, do buffer de salvamento.

BytesFilled

Um ponteiro para uma variável que recebe o número de bytes que foram copiados para o buffer de salvamento.

BytesRequired

Um ponteiro para uma variável que recebe o número de bytes necessários para que essa função progrida na próxima chamada.

Valor de retorno

VmbChannelSaveContinue retorna os seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	O estado foi salvo.
STATUS_BUFFER_TOO_SMALL	O buffer de salvamento era muito pequeno. O parâmetro BytesNeeded contém o número de bytes necessários para fazer qualquer progresso.
STATUS_STATUS_BUFFER_OVERFLOW	Alguns dados foram gravados no buffer de salvamento, mas há mais dados a serem salvos.

Observações

O processo de salvamento salva os dados em "partes" e pode continuar do ponto em que ele parou.

Se o chamador não alocar espaço suficiente com antecedência, várias chamadas poderão ser necessárias.

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 servidor acessada da estrutura KMCL_SERVER_ONLY_METHODS.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1803
cabeçalho	vmbuskernelmodeclientlibapi.h

Consulte também

VmbChannelSaveBegin

Compartilhar via