FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE fungsi panggilan balik (vmbuskernelmodeclientlibapi.h)

[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat atau tersirat, sehubungan dengan informasi yang diberikan di sini.]

Fungsi VmbConvertVmbusHandleToKernelHandle mengonversi handel VMBus mode pengguna ke handel mode kernel.

Sintaks

FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;

NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
  HANDLE VmbusHandle,
  PHANDLE KernelHandle
)
{...}

Parameter

VmbusHandle

Handel mode pengguna untuk dikonversi. Ini pasti dibuka dalam proses pekerja komputer virtual.

KernelHandle

Handel kernel yang mereferensikan objek yang sama dengan nilai VmbusHandle .

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika operasi berhasil, atau kode kesalahan NTSTATUS yang sesuai.

Keterangan

Pemanggil bertanggung jawab untuk menutup handel kernel.

Karena parameter VmbusHandle adalah handel mode pengguna, fungsi ini harus dipanggil dalam konteks proses mode pengguna yang membuka handel VMBus.

Memanggil fungsi ini sering kali segera diikuti dengan memanggil fungsi VmbServerChannelInitSetVmbusHandle .

Penting

Fungsi ini dipanggil melalui antarmuka VMBus Kernel Mode Client Library (KMCL), yang disediakan oleh driver bus Vmbkmcl.sys. Ini adalah fungsi khusus server yang diakses dari struktur KMCL_SERVER_ONLY_METHODS .

Untuk informasi selengkapnya, lihat bagian Keterangan di KMCL_SERVER_ONLY_METHODS.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1803
Header	vmbuskernelmodeclientlibapi.h

Lihat juga

VmbServerChannelInitSetVmbusHandle