função de retorno de chamada FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE (vmbuskernelmodeclientlibapi.h)
[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 |