OID_NIC_SWITCH_CREATE_VPORT

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_NIC_SWITCH_CREATE_VPORT untuk membuat port virtual (VPort) nondefault pada sakelar NIC adaptor jaringan. Permintaan metode OID ini juga melampirkan VPort yang dibuat ke Fungsi Fisik (PF) PCI Express (PCIe) adaptor jaringan atau Fungsi Virtual PCIe (VF) yang dialokasikan sebelumnya.

Driver yang terlalu berlebih mengeluarkan permintaan metode OID ini ke driver miniport untuk 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_VPORT_PARAMETERS .

Keterangan

Driver yang terlalu berlebihan menginisialisasi struktur NDIS_NIC_SWITCH_VPORT_PARAMETERS dengan informasi konfigurasi tentang VPort nondefault yang akan dibuat. Informasi konfigurasi mencakup fungsi PCIe tempat VPort nondefault terpasang dan jumlah pasangan antrean untuk VPort nondefault.

Ketika driver miniport PF mengeluarkan permintaan OID, driver mengalokasikan sumber daya perangkat keras dan perangkat lunak yang terkait dengan VPort nondefault yang ditentukan. Setelah semua sumber daya berhasil dialokasikan, driver miniport PF berhasil menyelesaikan OID dengan mengembalikan NDIS_STATUS_SUCCESS dari MiniportOidRequest.

Jika permintaan OID_NIC_SWITCH_CREATE_VPORT berhasil diselesaikan, driver miniport PF dan driver yang terlalu berlebihan harus mempertahankan nilai VPortId dari VPort nondefault untuk operasi berturut-turut. Nilai VPortId digunakan selama operasi ini:

NDIS dan driver yang terlalu berlebihan menggunakan nilai VPortId untuk mengidentifikasi VPort nondefault dalam permintaan OID berturut-turut yang terkait dengan VPort ini, seperti OID_NIC_SWITCH_VPORT_PARAMETERS dan OID_NIC_SWITCH_DELETE_VPORT.
Selama operasi pengiriman, NDIS menentukan nilai VPortId untuk mengidentifikasi VPort tempat paket dikirim. Nilai ini ditentukan dalam data NDIS_NET_BUFFER_LIST_FILTERING_INFO out-of-band (OOB) dari struktur NET_BUFFER_LIST .
Selama operasi penerimaan, driver miniport PF menentukan nilai VPortId tempat paket akan diteruskan. Nilai ini juga ditentukan dalam data NDIS_NET_BUFFER_LIST_FILTERING_INFO OOB dari struktur NET_BUFFER_LIST .

Untuk informasi selengkapnya, lihat Membuat Port Virtual.

Catatan VPort default selalu ada dan tidak dibuat melalui permintaan OID OID_NIC_SWITCH_CREATE_VPORT. VPort default memiliki pengidentifikasi NDIS_DEFAULT_VPORT_ID. Ketika driver miniport PF membuat sakelar NIC, driver secara otomatis melampirkan VPort default ke PF adaptor jaringan.

Mengembalikan Kode Status

NDIS atau driver miniport PF mengembalikan salah satu kode status berikut untuk permintaan metode OID OID_NIC_SWITCH_CREATE_SWITCH.

Kode Status	Deskripsi
NDIS_STATUS_SUCCESS	Permintaan OID berhasil diselesaikan.
NDIS_STATUS_NOT_SUPPORTED	Driver miniport PF tidak mendukung antarmuka SR-IOV atau tidak diaktifkan untuk menggunakan antarmuka.
NDIS_STATUS_INVALID_PARAMETER	Satu atau beberapa anggota struktur NDIS_NIC_SWITCH_VPORT_PARAMETERS memiliki nilai yang tidak valid.
NDIS_STATUS_INVALID_LENGTH	Panjang buffer informasi kurang dari sizeof(NDIS_NIC_SWITCH_VPORT_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.