FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE función de devolución de llamada (vmbuskernelmodeclientlibapi.h)
[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].
La función VmbConvertVmbusHandleToKernelHandle convierte el identificador VMBus del modo de usuario en el identificador del modo kernel.
Sintaxis
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;
NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
HANDLE VmbusHandle,
PHANDLE KernelHandle
)
{...}
Parámetros
VmbusHandle
Identificador del modo de usuario que se va a convertir. Esto debe haberse abierto en el proceso de trabajo de la máquina virtual.
KernelHandle
Identificador de kernel que hace referencia al mismo objeto que el valor vmbusHandle .
Valor devuelto
Devuelve STATUS_SUCCESS si la operación se realiza correctamente o un código de error NTSTATUS adecuado de lo contrario.
Comentarios
El autor de la llamada es responsable de cerrar el identificador del kernel.
Dado que el parámetro VmbusHandle es un identificador en modo de usuario, se debe llamar a esta función en el contexto del proceso en modo de usuario que abrió el identificador VMBus.
Llamar a esta función suele seguir inmediatamente llamando a la función VmbServerChannelInitSetVmbusHandle .
Importante
Esta función se llama a través de la interfaz de la biblioteca cliente del modo kernel de VMBus (KMCL), proporcionada por el controlador de bus de Vmbkmcl.sys. Se trata de una función de solo servidor a la que se accede desde la estructura de KMCL_SERVER_ONLY_METHODS .
Para obtener más información, vea la sección Comentarios de KMCL_SERVER_ONLY_METHODS.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1803 |
| Encabezado | vmbuskernelmodeclientlibapi.h |