FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE função de retorno de chamada (vmbuskernelmodeclientlibapi.h)
[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 VmbConvertVmbusHandleToKernelHandle converte o identificador VMBus do modo de usuário em identificador de 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 VmbusHandle valor.
Valor de retorno
Retorna STATUS_SUCCESS se a operação for bem-sucedida ou um código de erro NTSTATUS apropriado, caso contrário.
Observações
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 é seguido imediatamente chamando a 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 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 |