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 関数が呼び出されます。

大事な

この関数は、Vmbkmcl.sys バス ドライバーによって提供される VMBus カーネル モード クライアント ライブラリ (KMCL) インターフェイスを介して呼び出されます。 これは、KMCL_SERVER_ONLY_METHODS 構造体からアクセスされるサーバー専用の関数です。

詳細については、KMCL_SERVER_ONLY_METHODSの「解説」セクションを参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 1803
ヘッダー	vmbuskernelmodeclientlibapi.h

関連項目

VmbServerChannelInitSetVmbusHandle の