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
Header vmbuskernelmodeclientlibapi.h

こちらもご覧ください

VmbServerChannelInitSetVmbusHandle