ENABLE_VIRTUALIZATION fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas EnableVirtualization memungkinkan atau menonaktifkan virtualisasi untuk perangkat PCI Express (PCIe) yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).

Sintaks

ENABLE_VIRTUALIZATION EnableVirtualization;

NTSTATUS EnableVirtualization(
  [in, out] PVOID Context,
  [in]      UINT16 NumVFs,
  [in]      BOOLEAN EnableVfMigration,
  [in]      BOOLEAN EnableMigrationInterrupt,
  [in]      BOOLEAN EnableVirtualization
)
{...}

Parameter

[in, out] Context

Penunjuk ke informasi konteks khusus antarmuka. Pemanggil meneruskan nilai yang diteruskan sebagai anggota Konteks dari struktur PCI_VIRTUALIZATION_INTERFACE untuk antarmuka.

[in] NumVFs

Jumlah fungsi virtual PCIe (VF) yang akan diaktifkan untuk perangkat. Rutinitas EnableVirtualization menetapkan anggota NumVFs dari struktur PcIe SR-IOV Extended Capability ke nilai parameter NumVFs .

Jika parameter EnableVirtualizationFALSE, parameter NumVFs harus diatur ke nol.

[in] EnableVfMigration

Nilai BOOLEAN yang menunjukkan apakah fungsi dasar virtualisasi I/O multi-root (MR-IOV) (BF) dapat secara dinamis memprovisikan ulang fungsi fisik PCIe (PF) perangkat sebagai VF pada durasi.

Parameter ini hanya berlaku untuk perangkat yang mendukung antarmuka SR-IOV dan MR-IOV. Driver harus mengatur parameter ini ke FALSE jika perangkat hanya mendukung antarmuka SR-IOV dan bukan antarmuka MR-IOV.

[in] EnableMigrationInterrupt

Nilai BOOLEAN yang menunjukkan apakah gangguan yang terkait dengan PF harus ditutupi atau dilepaskan selama migrasi VF.

Jika parameter EnableVfMigrationFALSE, driver juga harus mengatur parameter ini ke FALSE.

[in] EnableVirtualization

Nilai BOOLEAN yang menunjukkan apakah virtualisasi diaktifkan pada ruang konfigurasi PCIe perangkat. Jika parameter EnableVirtualizationTRUE, rutin EnableVirtualization mengatur bit Aktifkan VF dari bidang Kontrol PCIe SR-IOV. Rutinitas EnableVirtualization menghapus bit ini jika parameter EnableVirtualizationFALSE.

Nilai kembali

Rutinitas EnableVirtualization mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Operasi berhasil diselesaikan.
STATUS_INVALID_PARAMETER Parameter NumVFs adalah nol atau lebih besar dari nilai anggota TotalVFs dari struktur SR-IOV Extended Capability untuk perangkat.
STATUS_INVALID_DEVICE_STATE Virtualisasi sudah diaktifkan pada perangkat dan parameter EnableVirtualizationtrue, atau virtualisasi sudah dinonaktifkan pada perangkat dan parameter EnableVirtualization adalah FALSE.

Keterangan

Driver memanggil rutinitas EnableVirtualization untuk mengonfigurasi bidang SR-IOV Extended Capability di ruang konfigurasi PCIe. Panggilan ini memungkinkan atau menonaktifkan virtualisasi di ruang konfigurasi, dan menentukan jumlah VF yang harus diekspos ke fabric PCIe oleh perangkat.

Rutinitas EnableVirtualization disediakan oleh antarmuka GUID_PCI_VIRTUALIZATION_INTERFACE .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di Windows Server 2012 dan versi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h)
IRQL IRQL <= DISPATCH_LEVEL

Lihat juga

PCI_VIRTUALIZATION_INTERFACE