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 |