共用方式為


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