FN_VMB_CHANNEL_RESTORE_FROM_BUFFER 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 VmbChannelRestoreFromBuffer restaura o estado do cliente do estado salvo anteriormente. O driver deve verificar o valor retornado da função.

Sintaxe

FN_VMB_CHANNEL_RESTORE_FROM_BUFFER FnVmbChannelRestoreFromBuffer;

NTSTATUS FnVmbChannelRestoreFromBuffer(
  VMBCHANNEL Channel,
  PVOID Buffer,
  ULONG BufferSize
)
{...}

Parâmetros

Channel

Um identificador para um canal.

Buffer

Um ponteiro para um buffer que contém o estado salvo anteriormente.

BufferSize

O tamanho, em bytes, do buffer.

Valor de retorno

VmbChannelRestoreFromBuffer retorna um dos seguintes valores de status:

Código de retorno	Descrição
STATUS_SUCCESS	A função foi concluída com êxito.
STATUS_MORE_PROCESSING_REQUIRED	O estado foi restaurado com êxito, mas mais partes foram salvas.
Outro código de status para o qual NT_SUCCESS é FALSE	Falha na função.

Observações

Espera-se que o chamador chame essa função com buffers que contêm "partes" inteiras de dados armazenados.

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

Partilhar via