função de retorno de chamada FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE (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 VmbConvertVmbusHandleToKernelHandle converte o identificador VMBus do modo de usuário para o identificador do modo kernel.

Sintaxe

FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;

NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
  HANDLE VmbusHandle,
  PHANDLE KernelHandle
)
{...}

Parâmetros

VmbusHandle

O identificador do modo de usuário a ser convertido. Isso deve ter sido aberto no processo de trabalho da máquina virtual.

KernelHandle

O identificador de kernel que faz referência ao mesmo objeto que o valor VmbusHandle .

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

O chamador é responsável por fechar o identificador do kernel.

Como o parâmetro VmbusHandle é um identificador de modo de usuário, essa função deve ser chamada no contexto do processo de modo de usuário que abriu o identificador VMBus.

Chamar essa função geralmente é imediatamente seguido pela chamada da função VmbServerChannelInitSetVmbusHandle .

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

Confira também

VmbServerChannelInitSetVmbusHandle