OID_SRIOV_BAR_RESOURCES
NDIS mengeluarkan permintaan metode pengidentifikasi objek (OID) dari OID_SRIOV_BAR_RESOURCES untuk menentukan sumber daya memori yang dialokasikan ke Daftar Alamat Dasar (BAR) PCI Express (PCIe) dari Fungsi Virtual PCIe (VF).
NDIS mengeluarkan permintaan metode OID ini ke driver miniport untuk PCIe Physical Function (PF) adaptor jaringan. Permintaan metode OID ini diperlukan untuk driver miniport PF yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).
Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi struktur berikut:
Struktur NDIS_SRIOV_BAR_RESOURCES_INFO yang menentukan VF dan BAR tempat driver miniport PF mengembalikan informasi sumber daya.
Struktur CM_PARTIAL_RESOURCE_DESCRIPTOR yang mengikuti struktur NDIS_SRIOV_BAR_RESOURCES_INFO . Struktur CM_PARTIAL_RESOURCE_DESCRIPTOR berisi informasi tentang sumber daya memori yang dialokasikan ke BAR yang ditentukan.
Keterangan
NDIS mengeluarkan permintaan metode OID OID_SRIOV_BAR_RESOURCES untuk mendapatkan alamat fisik sistem dan panjang sumber daya memori yang dialokasikan ke VF BAR. Sebelum mengeluarkan permintaan metode OID, NDIS memformat struktur NDIS_SRIOV_BAR_RESOURCES_INFO dengan cara berikut:
NDIS menetapkan anggota VFId dari struktur NDIS_SRIOV_BAR_RESOURCES_INFO ke pengidentifikasi yang terkait dengan VF.
NDIS menetapkan anggota BarIndex dari struktur NDIS_SRIOV_BAR_RESOURCES_INFO ke indeks BAR untuk VF yang ditentukan. Indeks BAR adalah offset dari register dalam tabel BAR di ruang konfigurasi PCI.
NDIS menetapkan anggota BarResourcesOffset dari struktur NDIS_SRIOV_BAR_RESOURCES_INFO ke offset, dalam satuan byte, dari awal struktur NDIS_SRIOV_BAR_RESOURCES_INFO ke struktur CM_PARTIAL_RESOURCE_DESCRIPTOR .
Catatan Driver yang terlalu berlebih, seperti driver protokol atau filter, tidak dapat mengeluarkan permintaan metode OID OID_SRIOV_BAR_RESOURCES ke driver miniport PF.
Ketika driver miniport PF menerima permintaan metode OID, driver mengembalikan sumber daya untuk BAR yang ditentukan dengan memformat struktur CM_PARTIAL_RESOURCE_DESCRIPTOR dalam anggota InformationBuffer dari struktur NDIS_OID_REQUEST . Driver memformat struktur CM_PARTIAL_RESOURCE_DESCRIPTOR dengan sumber daya perangkat keras sistem yang terkait dengan BAR untuk VF yang ditentukan.
Catatan Driver harus memformat struktur untuk jenis sumber daya CmResourceTypeMemory.
Mengembalikan Kode Status
Driver miniport PF mengembalikan salah satu kode status berikut untuk permintaan metode OID_SRIOV_BAR_RESOURCES.
| Kode Status | Deskripsi |
|---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
NDIS_STATUS_NOT_SUPPORTED |
Driver miniport PF tidak mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV) atau tidak diaktifkan untuk menggunakan antarmuka. |
NDIS_STATUS_INVALID_PARAMETER |
Satu atau beberapa anggota struktur NDIS_SRIOV_BAR_RESOURCES_INFO memiliki nilai yang tidak valid. |
NDIS_STATUS_INVALID_LENGTH |
Buffer informasi kurang dari (sizeof(NDIS_SRIOV_BAR_RESOURCES_INFO) + sizeof(CM_PARTIAL_RESOURCE_DESCRIPTOR). Driver miniport PF harus mengatur DATA. METHOD_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan. |
NDIS_STATUS_FAILURE |
Permintaan gagal karena alasan lain. |
Persyaratan
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk