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 |