OID_NIC_SWITCH_PARAMETERS

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan metode pengidentifikasi objek (OID) dari OID_NIC_SWITCH_PARAMETERS untuk mendapatkan parameter konfigurasi saat ini dari sakelar NIC tertentu pada adaptor jaringan. NDIS menangani permintaan metode OID ini untuk driver miniport.

Driver yang terlalu berlebih mengeluarkan permintaan set OID OID_NIC_SWITCH_PARAMETERS untuk mengatur parameter konfigurasi sakelar NIC tertentu pada adaptor jaringan. Permintaan set OID ini dikeluarkan untuk driver miniport dari Fungsi Fisik (PF) PCI Express (PCIe) adaptor jaringan. Permintaan set 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_PARAMETERS .

Driver yang terlalu berlebihan menentukan sakelar NIC untuk metode OID atau mengatur permintaan dengan mengatur anggota SwitchId dari struktur NDIS_NIC_SWITCH_PARAMETERS ke pengidentifikasi sakelar. Driver yang terlalu berlebihan mendapatkan pengidentifikasi sakelar melalui salah satu cara berikut:

Dari permintaan metode OID sebelumnya dari OID_NIC_SWITCH_ENUM_SWITCHES.
Dari anggota NicSwitchArray dari struktur NDIS_BIND_PARAMETERS . NDIS meneruskan pointer ke struktur ini dalam parameter BindParameters dari fungsi ProtocolBindAdapterEx .
Dari anggota NicSwitchArray dari struktur NDIS_FILTER_ATTACH_PARAMETERS . NDIS meneruskan penunjuk ke struktur ini dalam parameter AttachParameters dari fungsi FilterAttach .

Catatan Dimulai dengan Windows Server 2012, Windows hanya mendukung sakelar NIC default pada adaptor jaringan. Anggota SwitchId dari struktur NDIS_NIC_SWITCH_PARAMETERS harus diatur ke NDIS_DEFAULT_SWITCH_ID.

Keterangan

Masalah driver yang terlalu berlebihan OID_NIC_SWITCH_PARAMETERS permintaan dengan cara berikut:

Driver yang terlalu berlebihan mengeluarkan permintaan metode OID dari OID_NIC_SWITCH_PARAMETERS untuk mendapatkan parameter saat ini dari sakelar NIC yang ditentukan. Untuk informasi selengkapnya, lihat Mengkueri Parameter Pengalihan NIC.

Catatan NDIS menangani permintaan metode OID dari OID_NIC_SWITCH_PARAMETERS untuk driver miniport PF.
Driver yang terlalu berlebihan mengeluarkan permintaan set OID OID_NIC_SWITCH_PARAMETERS untuk mengubah parameter saat ini dari sakelar NIC yang ditentukan. Untuk informasi selengkapnya, lihat Mengatur Parameter Pengalihan NIC.

Catatan Driver miniport PF menangani permintaan OID_NIC_SWITCH_PARAMETERS yang ditetapkan OID.

Mengembalikan Kode Status

NDIS atau driver miniport PF mengembalikan kode status berikut untuk permintaan OID set atau metode OID_NIC_SWITCH_PARAMETERS.

Kode Status	Deskripsi
NDIS_STATUS_SUCCESS	Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES.
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_PARAMETERS memiliki nilai yang tidak valid.
NDIS_STATUS_INVALID_LENGTH	Buffer informasi terlalu pendek. NDIS atau driver miniport PF mengatur DATA. METHOD_INFORMATION. Anggota BytesNeeded (untuk permintaan metode OID) atau DATA. SET_INFORMATION. Anggota BytesNeeded (untuk permintaan set OID) dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.
NDIS_STATUS_REINIT_REQUIRED	Driver miniport PF memerlukan reinisialisasi adaptor jaringan untuk menerapkan perubahan pada sakelar NIC.
NDIS_STATUS_FAILURE	Permintaan gagal karena alasan lain.