функция обратного вызова FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE (vmbuskernelmodeclientlibapi.h)
[Некоторые сведения связаны с предварительно выпущенным продуктом, который может быть существенно изменен до его коммерческого выпуска. Корпорация Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых в отношении информации, предоставленной здесь.]
Функция VmbConvertVusHandleToKernelHandle преобразует дескриптор 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 |