FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE función de devolución de llamada (vmbuskernelmodeclientlibapi.h)
[Cierta información se relaciona con el producto publicado previamente que puede modificarse sustancialmente antes de su publicación comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.]
La función VmbConvertVmbusHandleToKernelHandle convierte el identificador VMBus en modo de usuario al 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. Debe haberse abierto en el proceso de trabajo de la máquina virtual.
KernelHandle
Identificador del kernel que hace referencia al mismo objeto que el valor de VmbusHandle.
Valor devuelto
Devuelve STATUS_SUCCESS si la operación se realiza correctamente o un código de error NTSTATUS adecuado de lo contrario.
Observaciones
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 ir seguida de inmediato 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 (KMCL) de VMBus, 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1803 |
| encabezado de | vmbuskernelmodeclientlibapi.h |