FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE callback function (vmbuskernelmodeclientlibapi.h)

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

The VmbConvertVmbusHandleToKernelHandle function converts the user mode VMBus handle to kernel mode handle.

Syntax

FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;

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

Parameters

VmbusHandle

The user-mode handle to convert. This must have been was opened in the virtual machine worker process.

KernelHandle

The kernel handle that references the same object as the VmbusHandle value.

Return value

Returns STATUS_SUCCESS if the operation succeeds, or an appropriate NTSTATUS error code otherwise.

Remarks

The caller is responsible for closing the kernel handle.

Because the VmbusHandle parameter is a user-mode handle, this function must be called in the context of the user-mode process which opened the VMBus handle.

Calling this function is often immediately followed by calling the VmbServerChannelInitSetVmbusHandle function.

Important

This function is called through the VMBus Kernel Mode Client Library (KMCL) interface, provided by the Vmbkmcl.sys bus driver. This is a server-only function accessed from the KMCL_SERVER_ONLY_METHODS structure.

For more information, see the Remarks section of KMCL_SERVER_ONLY_METHODS.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1803
Header vmbuskernelmodeclientlibapi.h

See also

VmbServerChannelInitSetVmbusHandle