OID_NIC_SWITCH_CREATE_SWITCH

Artikel
06/15/2023

NDIS mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_NIC_SWITCH_CREATE_SWITCH untuk membuat sakelar NIC pada adaptor jaringan. Ketika menangani permintaan OID ini, driver miniport mengalokasikan sumber daya untuk sakelar NIC pada adaptor.

NDIS mengeluarkan permintaan metode OID ini ke driver miniport fungsi fisik (PF) PCI Express (PCIe) adaptor jaringan. Permintaan metode OID ini diperlukan untuk driver miniport PF yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).

Catatan Driver yang terlalu berlebih, seperti driver protokol atau filter, tidak dapat mengeluarkan permintaan metode OID OID_NIC_SWITCH_CREATE_SWITCH ke driver miniport PF.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_NIC_SWITCH_PARAMETERS .

Keterangan

Ketika menerima permintaan metode OID dari OID_NIC_SWITCH_CREATE_SWITCH, driver miniport PF harus melakukan hal berikut:

Jika driver miniport PF mendukung pembuatan dan konfigurasi sakelar statis, itu membuat sakelar NIC saat NDIS memanggil MiniportInitializeEx. Ketika driver menangani permintaan OID ini, driver harus memverifikasi parameter konfigurasi dalam struktur NDIS_NIC_SWITCH_PARAMETERS . Parameter harus sama dengan yang digunakan oleh driver untuk membuat sakelar selama panggilan ke MiniportInitializeEx. Jika ini tidak benar, driver harus gagal dalam permintaan OID.

Untuk informasi selengkapnya, lihat Pembuatan Statis Sakelar NIC.
Jika driver miniport PF mendukung pembuatan dan konfigurasi sakelar dinamis, driver harus memvalidasi nilai konfigurasi struktur NDIS_NIC_SWITCH_PARAMETERS dan membuat sakelar NIC berdasarkan nilai-nilai ini.

Untuk informasi selengkapnya, lihat Pembuatan Dinamis Sakelar NIC.
Driver miniport PF harus mengalokasikan sumber daya perangkat keras dan perangkat lunak yang diperlukan untuk VPort default pada sakelar NIC.

Catatan VPort default selalu dibuat melalui permintaan OID OID_NIC_SWITCH_CREATE_SWITCH dan dihapus melalui permintaan OID OID_NIC_SWITCH_DELETE_SWITCH. Permintaan OID OID_NIC_SWITCH_CREATE_VPORT dan OID_NIC_SWITCH_DELETE_VPORT digunakan untuk pembuatan dan penghapusan VPort nondefault pada sakelar NIC.
Driver miniport PF yang mendukung pembuatan dan konfigurasi sakelar dinamis harus mengaktifkan virtualisasi SR-IOV pada sakelar dengan memanggil NdisMEnableVirtualization. Panggilan ini mengonfigurasi anggota NumVFs dan bit VF Enable di struktur SR-IOV Extended Capability dari ruang konfigurasi PCI Express (PCIe) adaptor.

Untuk informasi selengkapnya tentang ruang konfigurasi SR-IOV, lihat spesifikasi PCI-SIG Single Root I/O Virtualization dan Sharing 1.1 .

Catatan Jika driver miniport PF mendukung pembuatan sakelar statis, itu memungkinkan virtualisasi SR-IOV setelah membuat sakelar saat MiniportInitializeEx dipanggil.

Jika driver miniport PF berhasil menyelesaikan permintaan metode OID OID_NIC_SWITCH_CREATE_SWITCH, hal ini memungkinkan hal berikut terjadi:

VF dapat dialokasikan pada sakelar NIC melalui permintaan metode OID OID_NIC_SWITCH_ALLOCATE_VF.
VPort nondefault dapat dibuat pada sakelar NIC melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.

Untuk informasi selengkapnya tentang cara menangani permintaan OID ini, lihat Menangani Permintaan OID_NIC_SWITCH_CREATE_SWITCH.

Mengembalikan Kode Status

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_PARAMETERS memiliki nilai yang tidak valid.
NDIS_STATUS_INVALID_LENGTH	Panjang buffer informasi kurang dari sizeof(NDIS_NIC_SWITCH_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.