FN_VMB_CHANNEL_CREATE_GPADL_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 VmbChannelCreateGpadlFromBuffer cria uma GPADL (Lista de Descritores de Endereço Físico Convidado) que descreve um buffer do lado do cliente. O GPADL pode ser usado no servidor para acessar o buffer.

Sintaxe

FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER FnVmbChannelCreateGpadlFromBuffer;

NTSTATUS FnVmbChannelCreateGpadlFromBuffer(
  VMBCHANNEL Channel,
  UINT32 Flags,
  PVOID Buffer,
  UINT32 ByteCount,
  PUINT32 GpadlHandle
)
{...}

Parâmetros

Channel

Um identificador para um canal.

Flags

Sinalizadores. Os seguintes valores são possíveis:

Valor Significado
VMBUS_CHANNEL_GPADL_READ_ONLY
 Se você especificar esse valor, o buffer será somente leitura. Caso contrário, o servidor poderá gravar no buffer. Essa não é uma medida de segurança, mas pode melhorar instantâneo e o desempenho da migração ao vivo.

Buffer

O buffer, que é investigado e bloqueado até que o GPADL seja derrubado.

ByteCount

O comprimento do buffer, em bytes.

GpadlHandle

Um identificador GPADL da MDL (Lista de Descritores de Memória) criada. Envie isso para o servidor a ser usado com a função VmbChannelMapGpadl .

Retornar valor

Retorna STATUS_SUCCESS se a operação for bem-sucedida ou um código de erro NTSTATUS apropriado caso contrário.

Comentários

Quando essa função retorna, o ponto de extremidade do servidor pode chamar VmbChannelMapGpadl, pois o VMBus já terá enviado a descrição do GPADL para o ponto de extremidade oposto e recebido a confirmação.

O GPADL deve ser excluído usando a função VmbChannelDeleteGpadl .

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 de cliente acessada da estrutura KMCL_CLIENT_INTERFACE_V1 .

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

Requisitos

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

Confira também

VmbChannelDeleteGpadl

VmbChannelMapGpadl