OID_SRIOV_RESET_VF
Driver yang terlalu berlebihan mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SRIOV_RESET_VF untuk mengatur ulang Fungsi Virtual (VF) PCI Express (PCIe) tertentu pada adaptor jaringan yang mendukung virtualisasi I/O root tunggal. Driver yang terlalu berlebih mengeluarkan permintaan set OID ini ke driver miniport Fungsi Fisik (PF) PCI Express (PCIe) dari adaptor jaringan.
Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SRIOV_RESET_VF_PARAMETERS . Driver yang terlalu berlebihan menentukan pengidentifikasi VF yang akan direset melalui anggota VFId dari struktur ini.
Keterangan
VF dapat direset melalui PCI Express (PCIe) Function Level Reset (FLR). Karena permintaan FLR adalah operasi istimewa, permintaan hanya dapat dilakukan oleh driver miniport PF yang berjalan dalam sistem operasi manajemen partisi induk Hyper-V. Driver yang terlalu mengandalkan yang berjalan dalam sistem operasi manajemen diberi tahu tentang permintaan FLR dan mengeluarkan permintaan set OID OID_SRIOV_RESET_VF ke driver miniport PF.
Ketika menangani permintaan OID ini, driver miniport PF harus mengikuti panduan berikut:
Driver miniport PF harus memverifikasi bahwa VF, yang ditentukan oleh anggota VFId dari struktur NDIS_SRIOV_RESET_VF_PARAMETERS , memiliki sumber daya yang sebelumnya telah dialokasikan. Driver miniport PF mengalokasikan sumber daya untuk VF selama permintaan metode OID OID_NIC_SWITCH_ALLOCATE_VF. Jika sumber daya untuk VF yang ditentukan belum dialokasikan, driver harus gagal dalam permintaan OID.
Operasi reset hanya boleh memengaruhi VF yang ditentukan. Operasi tidak boleh memengaruhi VF lain atau PF pada adaptor jaringan yang sama.
Untuk informasi selengkapnya, lihat Mereset Fungsi Virtual.
Mengembalikan Kode Status
Driver miniport PF mengembalikan salah satu kode status berikut untuk permintaan OID_SRIOV_RESET_VF yang ditetapkan.
| 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_RESET_VF_PARAMETERS memiliki nilai yang tidak valid. |
NDIS_STATUS_INVALID_LENGTH |
Buffer informasi terlalu pendek. Driver miniport PF harus mengatur DATA. SET_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) |