OID_SWITCH_NIC_UPDATED

Artikel
06/14/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_UPDATED ke tumpukan driver sakelar yang dapat diperluas. Permintaan OID ini memberi tahu ekstensi sakelar yang dapat diperluas tentang pembaruan parameter adaptor jaringan. OID hanya akan dikeluarkan untuk NIC yang telah terhubung, dan belum memulai proses pemutusan sambungan. Perubahan konfigurasi run-time ini dapat mencakup NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress, dan VFAssigned.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SWITCH_NIC_PARAMETERS .

Keterangan

Anggota PortId dari struktur NDIS_SWITCH_NIC_PARAMETERS menentukan port tempat pemberitahuan pembaruan dibuat. Ekstensi sakelar yang dapat diperluas dapat memperoleh informasi parameter untuk port ini dan port lain pada sakelar yang dapat diperluas dengan mengeluarkan permintaan kueri OID dari OID_SWITCH_PORT_ARRAY.

Anggota Indeks dari struktur NDIS_SWITCH_NIC_PARAMETERS menentukan indeks adaptor jaringan tempat pemberitahuan pembaruan dibuat. Adaptor jaringan dengan nilai Indeks yang ditentukan tersambung ke port sakelar yang dapat diperluas yang ditentukan oleh anggota PortId . Untuk informasi selengkapnya tentang nilai indeks ini, lihat Nilai Indeks Adapter Jaringan.

Ekstensi harus mengikuti panduan ini untuk menangani permintaan OID_SWITCH_NIC_UPDATED yang ditetapkan OID:

Ekstensi tidak boleh mengubah struktur NDIS_SWITCH_NIC_PARAMETERS yang terkait dengan permintaan OID.
Ekstensi harus selalu meneruskan permintaan set OID ini ke ekstensi yang mendasar. Ekstensi tidak boleh menyelesaikan permintaan.
Ekstensi tidak boleh mengeluarkan permintaan set OID sendiri dari OID_SWITCH_NIC_UPDATED.

Mengembalikan Kode Status

Tepi miniport yang mendasar dari sakelar yang dapat diperluas menyelesaikan permintaan kueri OID OID_SWITCH_NIC_UPDATED dan mengembalikan kode status berikut.