OID_SRIOV_SET_VF_POWER_STATE
Driver yang terlalu berlebihan mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SRIOV_SET_VF_POWER_STATE untuk mengubah status daya Fungsi Virtual (VF) PCI Express (PCIe) tertentu pada adaptor jaringan. Karena mengubah status daya adalah operasi istimewa, driver yang terlalu berlebihan mengeluarkan permintaan set OID ini ke driver miniport fungsi fisik PCIe (PF) pada adaptor jaringan. Driver miniport PF kemudian mengatur status daya yang ditentukan pada VF.
Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS .
Keterangan
Ketika driver miniport PF dikeluarkan permintaan set OID ini, itu harus mengikuti panduan berikut:
Driver miniport PF harus memverifikasi bahwa VF, yang ditentukan oleh anggota VFId dari struktur NDIS_SRIOV_SET_VF_POWER_STATE_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 VF yang ditentukan tidak dalam status dialokasikan, driver harus gagal dalam permintaan OID.
Operasi status daya hanya boleh memengaruhi VF yang ditentukan. Operasi tidak boleh memengaruhi VF lain atau PF pada adaptor jaringan yang sama.
Untuk informasi selengkapnya, lihat Mengatur Status Daya Fungsi Virtual.
Mengembalikan Kode Status
Driver miniport PF mengembalikan salah satu kode status berikut untuk permintaan set OID OID_SRIOV_SET_VF_POWER_STATE.
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_SET_VF_POWER_STATE_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) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk