OID_SWITCH_NIC_CONNECT

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_CONNECT untuk memberi tahu ekstensi sakelar yang dapat diperluas yang mendasar bahwa koneksi jaringan antara port sakelar yang dapat diperluas dan adaptor jaringan benar-benar dibuat. Tepi protokol sebelumnya memberi tahu ekstensi bahwa koneksi ini sedang dibuat ketika mengeluarkan permintaan set OID OID_SWITCH_NIC_CREATE.

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 sakelar yang dapat diperluas di mana pemberitahuan sambungkan sedang dibuat. Ekstensi sakelar yang dapat diperluas dapat memperoleh informasi parameter untuk port ini dan port sakelar yang dapat diperluas lainnya dengan cara berikut:

Dengan mengeluarkan permintaan kueri OID dari OID_SWITCH_PORT_ARRAY. Ekstensi mengeluarkan OID ini pada FilterAttach hanya ketika OID_SWITCH_PARAMETERS mengembalikan struktur NDIS_SWITCH_PARAMETERS dengan IsActive yang diatur ke TRUE. Jika IsActive FALSE, ekstensi mengeluarkan OID saat NET_PNP_EVENT NetEventSwitchActivate dikeluarkan oleh adaptor miniport ekstensi.
Dengan memeriksa berbagai permintaan set OID OID_SWITCH_PORT_CREATE dan OID_SWITCH_PORT_DELETE.

Anggota indeks struktur NDIS_SWITCH_NIC_PARAMETERS menentukan indeks adaptor jaringan tempat pemberitahuan koneksi 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.

Saat menerima permintaan set OID OID_SWITCH_NIC_CONNECT, ekstensi harus mengikuti panduan berikut:

Ketika permintaan OID_SWITCH_NIC_CONNECT selesai dengan NDIS_STATUS_SUCCESS, koneksi jaringan dan port sakelar yang dapat diperluas beroperasi penuh. Ekstensi dapat menghasilkan atau meneruskan lalu lintas paket ke koneksi jaringan port. Ekstensi juga dapat mengeluarkan OID sakelar yang dapat diperluas atau indikasi status yang menggunakan port sebagai port sumber. Ekstensi juga dapat memanggil ReferenceSwitchPort untuk menaikkan penghitung referensi sakelar yang dapat diperluas untuk port.
Ekstensi tidak boleh mengubah struktur NDIS_SWITCH_NIC_PARAMETERS yang terkait dengan permintaan OID.
Ekstensi harus selalu memanggil NdisFOidRequest untuk meneruskan permintaan OID ini ke ekstensi yang mendasar. Ekstensi tidak boleh menyelesaikan permintaan OID itu sendiri.
Adaptor jaringan eksternal sakelar yang dapat diperluas dapat mengikat ke satu atau beberapa adaptor fisik yang mendasar. Untuk setiap adaptor jaringan fisik yang terikat ke adaptor jaringan eksternal, tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan set OID_SWITCH_NIC_CONNECT OID terpisah. Setiap permintaan set OID menentukan nilai indeks koneksi adaptor jaringan yang berbeda. Untuk informasi selengkapnya tentang nilai-nilai ini, lihat Nilai Indeks Adapter Jaringan.

Ekstensi harus mempertahankan status koneksi untuk setiap adaptor fisik yang mendasar yang terikat ke adaptor jaringan eksternal. Untuk informasi selengkapnya tentang berbagai konfigurasi di mana adaptor jaringan fisik dapat terikat ke adaptor jaringan eksternal, lihat Jenis Konfigurasi Adaptor Jaringan Fisik.

Catatan Ekstensi tidak boleh mengeluarkan permintaan set OID sendiri dari OID_SWITCH_NIC_CONNECT.

Untuk informasi selengkapnya tentang status port sakelar yang dapat diperluas dan koneksi adaptor jaringan, lihat Port Hyper-V Extensible Switch dan Status Adaptor Jaringan.

Mengembalikan Kode Status

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