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)

Lihat juga


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF