OID_NIC_SWITCH_VF_PARAMETERS

Artikel
06/15/2023

Aplikasi driver atau mode pengguna yang terlalu berlebihan mengeluarkan permintaan metode pengidentifikasi objek (OID) dari OID_NIC_SWITCH_VF_PARAMETERS untuk mendapatkan parameter konfigurasi saat ini dari Fungsi Virtual (VF) PCI Express (PCIe) pada adaptor jaringan. Hanya VF yang memiliki sumber daya yang dialokasikan melalui permintaan metode OID OID_NIC_SWITCH_ALLOCATE_VF yang dapat dikueri melalui permintaan metode OID OID_NIC_SWITCH_VF_PARAMETERS.

NDIS menangani permintaan metode OID OID_NIC_SWITCH_VF_PARAMETERS untuk driver miniport.

Ketika permintaan metode OID dibuat, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi pointer ke struktur NDIS_NIC_SWITCH_VF_PARAMETERS .

Keterangan

Aplikasi driver atau mode pengguna yang terlalu berlebihan menentukan VF untuk dikueri dengan mengatur anggota VFId dari struktur NDIS_NIC_SWITCH_VF_PARAMETERS ke pengidentifikasi VF. Driver atau aplikasi yang terlalu berlebihan mendapatkan pengidentifikasi VF melalui salah satu cara berikut:

Dengan mengeluarkan permintaan metode OID dari OID_NIC_SWITCH_ENUM_VFS.

Jika permintaan OID ini berhasil diselesaikan, driver yang berlebihan atau aplikasi mode pengguna menerima daftar semua VF yang dialokasikan pada adaptor jaringan. Setiap elemen dalam daftar adalah struktur NDIS_NIC_SWITCH_VF_INFO , dengan pengidentifikasi VF yang ditentukan oleh anggota VFId .
Dengan mengeluarkan permintaan metode OID dari OID_NIC_SWITCH_ALLOCATE_VF.

Jika permintaan OID ini berhasil diselesaikan, driver yang terlalu berlebihan menerima pengidentifikasi VF yang baru dibuat di anggota VFId dari struktur NDIS_NIC_SWITCH_VF_PARAMETERS yang dikembalikan.

Catatan Hanya driver yang terlalu mengandalkan yang dapat memperoleh pengidentifikasi VF dengan cara ini.

Setelah berhasil mengembalikan dari permintaan metode OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi pointer ke struktur NDIS_NIC_SWITCH_VF_PARAMETERS . Struktur ini berisi parameter konfigurasi untuk VF yang ditentukan.

Mengembalikan Kode Status

NDIS menangani permintaan metode OID OID_NIC_SWITCH_VF_PARAMETERS untuk driver miniport, dan mengembalikan kode status berikut untuk permintaan metode OID OID_NIC_SWITCH_VF_PARAMETERS.

Kode Status	Deskripsi
NDIS_STATUS_SUCCESS	Permintaan berhasil diselesaikan. Anggota InformationBuffer menunjuk ke struktur NDIS_NIC_SWITCH_VF_PARAMETERS .
NDIS_STATUS_NOT_SUPPORTED	Driver miniport 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). NDIS mengatur DATA. METHOD_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.
NDIS_STATUS_INVALID_LENGTH	Buffer informasi terlalu pendek. NDIS 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.