FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE回调函数 (vmbuskernelmodeclientlibapi.h)

[一些信息与预发布产品相关,在商业发行之前可能发生实质性修改。 Microsoft 对于此处提供的信息不作任何明示或默示的担保。]

VmbConvertVmbusHandleToKernelHandle 函数将用户模式 VMBus 句柄转换为内核模式句柄。

语法

FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;

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

参数

VmbusHandle

要转换的用户模式句柄。 这必须在虚拟机工作进程中打开。

KernelHandle

引用与 VmbusHandle 值相同的对象的内核句柄。

返回值

如果操作成功,则返回STATUS_SUCCESS,否则返回相应的 NTSTATUS 错误代码。

注解

调用方负责关闭内核句柄。

由于 VmbusHandle 参数是用户模式句柄,因此必须在打开 VMBus 句柄的用户模式进程的上下文中调用此函数。

调用此函数通常紧接着调用 VmbServerChannelInitSetVmbusHandle 函数。

重要

此函数通过 VMBus 内核模式客户端库 (KMCL) 接口调用,由 Vmbkmcl.sys 总线驱动程序提供。 这是从 KMCL_SERVER_ONLY_METHODS 结构访问的仅限服务器的函数。

有关详细信息,请参阅 KMCL_SERVER_ONLY_METHODS的“备注”部分。

要求

要求
最低受支持的客户端 Windows 10 版本 1803
标头 vmbuskernelmodeclientlibapi.h

另请参阅

VmbServerChannelInitSetVmbusHandle