Fungsi NdisGetHypervisorInfo (ndis.h)

  • Artikel
Penting  

Dimulai dengan Windows 10 Versi 1703, NdisGetHypervisorInfo tidak digunakan lagi dan tidak boleh digunakan. Driver didorong untuk menjauh darinya, karena mungkin tidak tersedia dalam versi sistem operasi yang akan datang.

Driver harus mengikuti instruksi hypervisor untuk mengkueri kehadiran dan kemampuan hypervisor. Misalnya, instruksi Hyper-V didokumenkan dalam Spesifikasi Fungsional Tingkat Atas.

Fungsi NdisGetHypervisorInfo mengembalikan informasi tentang hypervisor yang ada di sistem.

Sintaks

NDIS_STATUS NdisGetHypervisorInfo(
  [in, out] PNDIS_HYPERVISOR_INFO HypervisorInfo
);

Parameter

[in, out] HypervisorInfo

Penunjuk ke struktur NDIS_HYPERVISOR_INFO yang dialokasikan penelepon yang berisi informasi tentang hypervisor yang ada di sistem.

Nilai kembali

NdisGetHypervisorInfo dapat mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
NDIS_STATUS_SUCCESS
 Operasi berhasil diselesaikan.
NDIS_STATUS_BUFFER_TOO_SHORT
 Ukuran buffer parameter input terlalu kecil.

Keterangan

Driver miniport NDIS memanggil fungsi NdisGetHypervisorInfo untuk menentukan apakah hypervisor ada pada sistem.

Saat fungsi NdisGetHypervisorInfo kembali, parameter HypervisorInfo berisi penunjuk ke struktur NDIS_HYPERVISOR_INFO . Struktur ini berisi informasi tentang apakah hypervisor ada, bersama dengan jenis partisi tempat fungsi ini dipanggil. Struktur NDIS_HYPERVISOR_INFO menyediakan informasi ini dengan cara berikut:

  • Jika hypervisor ada, bendera NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT diatur di anggota Bendera .
  • Jika hypervisor Microsoft ada, anggota PartitionType diatur ke salah satu nilai berikut:
    • Jika fungsi NdisGetHypervisorInfo dipanggil dari sistem operasi manajemen yang berjalan di partisi induk Hyper-V, anggota PartitionType diatur ke NdisHypervisorPartitionTypeMsHvParent.
    • Jika fungsi NdisGetHypervisorInfo dipanggil dari sistem operasi tamu yang berjalan di partisi anak Hyper-V, anggota PartitionType diatur ke NdisHypervisorPartitionMsHvChild.
  • Jika hypervisor vendor lain ada, anggota PartitionType diatur ke NdisHypervisorPartitionTypeUnknown.
Catatan Driver harus menginisialisasi anggota Header dari struktur NDIS_HYPERVISOR_INFO sebelum memanggil fungsi NdisGetHypervisorInfo .
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform Universal
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL <= DISPATCH_LEVEL

Lihat juga

NDIS_HYPERVISOR_INFO