struktur PCI_VIRTUALIZATION_INTERFACE (wdm.h)
Struktur PCI_VIRTUALIZATION_INTERFACE memungkinkan driver mengelola dan mengonfigurasi ruang konfigurasi PCI Express (PCIe) untuk fungsi virtual (VF). VF diekspos pada bus PCI oleh perangkat yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).
Struktur ini menjelaskan antarmuka GUID_PCI_VIRTUALIZATION_INTERFACE .
Sintaks
typedef struct _PCI_VIRTUALIZATION_INTERFACE {
USHORT Size;
USHORT Version;
PVOID Context;
PINTERFACE_REFERENCE InterfaceReference;
PINTERFACE_DEREFERENCE InterfaceDereference;
PSET_VIRTUAL_DEVICE_DATA SetVirtualFunctionData;
PGET_VIRTUAL_DEVICE_DATA GetVirtualFunctionData;
PGET_VIRTUAL_DEVICE_LOCATION GetLocation;
PGET_VIRTUAL_DEVICE_RESOURCES GetResources;
PENABLE_VIRTUALIZATION EnableVirtualization;
PGET_VIRTUAL_FUNCTION_PROBED_BARS GetVirtualFunctionProbedBars;
} PCI_VIRTUALIZATION_INTERFACE, *PPCI_VIRTUALIZATION_INTERFACE;
Anggota
Size
Ukuran, dalam byte, dari struktur ini.
Version
Versi antarmuka yang ditentukan driver.
Context
Penunjuk ke informasi konteks khusus antarmuka.
InterfaceReference
Penunjuk ke rutinitas InterfaceReference yang menaikkan jumlah referensi antarmuka.
InterfaceDereference
Penunjuk ke rutinitas InterfaceDereference yang mengurangi jumlah referensi antarmuka.
SetVirtualFunctionData
Penunjuk ke rutinitas SetVirtualFunctionData yang menulis data ke ruang konfigurasi PCIe dari VF perangkat SR-IOV.
GetVirtualFunctionData
Pointer ke rutinitas GetVirtualFunctionData yang membaca data dari ruang konfigurasi PCIe dari VF perangkat SR-IOV.
GetLocation
Penunjuk ke rutinitas GetLocation yang menyediakan informasi tentang lokasi perangkat VF saat ini dalam hierarki PCIe. Informasi ini diperlukan untuk sistem virtualisasi yang menggunakan unit manajemen memori I/O (IOMMU) untuk merutekan lalu lintas ke atau dari perangkat.
GetResources
Penunjuk ke rutinitas GetResources yang menyediakan informasi tentang sumber daya yang tersedia untuk virtualisasi pada perangkat SR-IOV.
EnableVirtualization
Penunjuk ke rutinitas EnableVirtualization yang memungkinkan atau menonaktifkan virtualisasi pada perangkat SR-IOV.
GetVirtualFunctionProbedBars
Penunjuk ke rutinitas GetVirtualFunctionProbedBars yang memungkinkan komputer virtual Hyper-V (VM) non-istimewa untuk menentukan apa yang akan dibaca dari PCIe Base Address Registers (BAR) VF setelah kueri oleh driver bus PCI. Driver PCI melakukan kueri ini untuk menentukan ruang alamat memori atau I/O yang diperlukan perangkat.
Keterangan
Untuk perangkat yang mendukung antarmuka SR-IOV, driver terkadang harus mengakses dan mengelola ruang konfigurasi PCIe VF perangkat. Driver memanggil rutinitas dari antarmuka GUID_PCI_VIRTUALIZATION_INTERFACE untuk mengakses ruang konfigurasi PCIe VF pada perangkat.
Karena VF perangkat tidak muncul sebagai perangkat PCIe lengkap pada bus PCI, antarmuka GUID_BUS_INTERFACE_STANDARD tidak dapat digunakan untuk manajemen VF.
Struktur PCI_VIRTUALIZATION_INTERFACE adalah perpanjangan dari struktur INTERFACE .
Driver mendapatkan penunjuk ke struktur PCI_VIRTUALIZATION_INTERFACE dengan mengirim paket permintaan I/O (IRP) IRP_MN_QUERY_INTERFACE ke driver busnya dengan InterfaceType diatur ke GUID_PCI_VIRTUALIZATION_INTERFACE.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Server minimum yang didukung | Windows Server 2012 |
| Header | wdm.h (termasuk Wdm.h) |