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)

Lihat juga

GUID_BUS_INTERFACE_STANDARD

InterfaceDereference

InterfaceReference

IRP_MN_QUERY_INTERFACE