FN_VMB_CHANNEL_RESTORE_FROM_BUFFER função de retorno de chamada (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 VmbChannelRestoreFromBuffer restaura o estado do cliente do estado salvo anteriormente. O driver deve marcar 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 do buffer, em bytes.

Retornar valor

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 status para o qual NT_SUCCESS é FALSE
 Falha na função.

Comentários

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 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho vmbuskernelmodeclientlibapi.h