GET_VIRTUAL_DEVICE_RESOURCES fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas GetResources mengembalikan sumber daya yang diperlukan fungsi fisik (PF) PCI Express (PCIe) untuk mengaktifkan virtualisasi pada perangkat yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).

Sintaks

GET_VIRTUAL_DEVICE_RESOURCES GetVirtualDeviceResources;

void GetVirtualDeviceResources(
  [in, out] PVOID Context,
  [out]     PUINT8 CapturedBusNumbers
)
{...}

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.

[out] CapturedBusNumbers

Penunjuk ke variabel yang disediakan penelepon di mana rutinitas ini mengembalikan nilai UINT8. Nilai ini menentukan jumlah bus PCIe yang telah ditangkap untuk digunakan oleh SR-IOV PF perangkat.

Nilai kembali

Tidak ada

Keterangan

Perangkat PCIe biasanya menggunakan sumber daya pada satu bus PCI. Driver PCI menetapkan perangkat ke bus PCI dengan menulis nomor bus ke register Nomor Bus Sekunder dan register Nomor Bus Subordinat di port jembatan upstream. Port ini adalah jembatan PCI-ke-PCI dalam port akar PCIe atau port sakelar PCIe.

Perangkat yang mendukung antarmuka SR-IOV dapat membuat lebih banyak fungsi virtual daripada yang dapat diakomodasi pada bus PCI tempat perangkat terhubung. Dalam situasi ini, port jembatan upstream harus dikonfigurasi untuk menangkap satu atau beberapa bus PCI yang tidak digunakan. Ini dilakukan dengan menulis nilai yang lebih besar ke register Nomor Bus Bawahan port.

Perangkat yang mendukung antarmuka SR-IOV harus mengambil bus PCI jika setidaknya salah satu hal berikut ini benar:

  • Perangkat ini memiliki lebih dari delapan fungsi total (PF dan VF) dan perangkat tidak mendukung opsi Interpretasi Perutean Alternatif (ARI) dari spesifikasi PCI Express 3.0.

  • Perangkat ini mendukung ARI dan memiliki lebih dari delapan fungsi total, tetapi port jembatan upstram tidak mendukung ARI.

  • Perangkat ini mendukung ARI dan memiliki lebih dari 256 fungsi, dan port jembatan upstram mendukung ARI.

Terlepas dari dukungan ARI, setiap bus yang ditangkap dapat mendukung 256 fungsi.

Jika perangkat membutuhkan lebih banyak ID Pemohon PCIe (RID) untuk mengaktifkan semua VF-nya, driver bus PCI melakukan hal berikut:

  1. Menulis nomor bus perangkat ke dalam register Nomor Bus Sekunder PCIe.

  2. Menulis nilai yang lebih besar dari nomor bus perangkat ke dalam register Nomor Bus Subordinat PCIe.

Perbedaan antara kedua nilai register ini menunjukkan jumlah nomor bus yang ditangkap.

Rutinitas GetResources 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 PASSIVE_LEVEL

Lihat juga

PCI_VIRTUALIZATION_INTERFACE