функция обратного вызова FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE (vmbuskernelmodeclientlibapi.h)

  • Статья

[Некоторые сведения относятся к предварительно выпущенным продуктам, которые могут быть существенно изменены до его коммерческого выпуска. Майкрософт не дает никаких гарантий, явных или подразумеваемых, в отношении предоставленной здесь информации.]

Функция 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