OID_NIC_SWITCH_ALLOCATE_VF
Driver yang terlalu berlebihan mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_NIC_SWITCH_ALLOCATE_VF untuk mengalokasikan sumber daya untuk Fungsi Virtual (VF) PCI Express (PCIe). VF diekspos pada adaptor jaringan yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).
Driver yang terlalu berlebih 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 struktur NDIS_NIC_SWITCH_VF_PARAMETERS .
Keterangan
Driver miniport PF mengalokasikan sumber daya perangkat lunak untuk VF ketika driver menangani permintaan metode pengidentifikasi objek (OID) OID_NIC_SWITCH_ALLOCATE_VF. Meskipun sumber daya perangkat keras telah dialokasikan untuk VF, itu dianggap tidak bersifat nonoperational sampai driver miniport PF berhasil menyelesaikan OID_NIC_SWITCH_ALLOCATE_VF.
Untuk informasi selengkapnya tentang cara mengalokasikan sumber daya VF, lihat Mengalokasikan Sumber Daya untuk Fungsi Virtual.
Catatan Setelah driver yang terlalu berlebihan meminta alokasi sumber daya untuk VF, driver tersebut adalah satu-satunya komponen yang dapat meminta pengosongan sumber daya untuk VF yang sama. Driver yang terlalu berlebihan harus mengeluarkan permintaan set OID OID_NIC_SWITCH_FREE_VF untuk membebaskan sumber daya VF. Sebelum driver yang terlalu besar dapat dihentikan, driver harus membebaskan sumber daya untuk setiap VF yang dialokasikan oleh permintaan OID_NIC_SWITCH_ALLOCATE_VF driver.
Mengembalikan Kode Status
Driver miniport PF mengembalikan salah satu kode status berikut untuk permintaan metode OID OID_NIC_SWITCH_ALLOCATE_VF.
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_NIC_SWITCH_VF_PARAMETERS memiliki nilai yang tidak valid. |
NDIS_STATUS_INVALID_LENGTH |
Panjang buffer informasi kurang dari sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). 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) |