OID_SWITCH_NIC_DISCONNECT

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_DISCONNECT untuk memberi tahu ekstensi sakelar yang dapat diperluas yang mendasar bahwa koneksi antara port sakelar yang dapat diperluas dan adaptor jaringan sedang ditumbangkan. Setelah koneksi benar-benar terkoyak, tepi protokol sakelar yang dapat diperluas akan mengeluarkan permintaan set OID_SWITCH_NIC_DELETE OID.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SWITCH_NIC_PARAMETERS .

Keterangan

Anggota Indeks dari struktur NDIS_SWITCH_NIC_PARAMETERS menentukan indeks adaptor jaringan tempat pemberitahuan pemutusan sambungan 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 saat menangani permintaan set OID_SWITCH_NIC_DISCONNECT OID:

Ekstensi tidak boleh mengubah struktur NDIS_SWITCH_NIC_PARAMETERS yang terkait dengan permintaan OID.
Permintaan OID_SWITCH_NIC_DISCONNECT hanya memberi tahu ekstensi bahwa koneksi sakelar yang dapat diperluas sedang ditumbangkan antara adaptor jaringan yang ditentukan dan port sakelar yang dapat diperluas. Setelah ekstensi menangani permintaan OID ini, ekstensi tidak boleh melakukan hal berikut:
- Hasilkan lalu lintas paket apa pun ke koneksi adaptor jaringan pada port sakelar yang dapat diperluas di mana permintaan OID OID_SWITCH_NIC_DISCONNECT dikeluarkan.
- Panggil ReferenceSwitchNic untuk menaikkan penghitung referensi sakelar yang dapat diperluas untuk koneksi adaptor jaringan yang ditentukan pada port sakelar yang dapat diperluas.
- Meneruskan atau berasal dari permintaan OID OID_SWITCH_NIC_REQUEST ke adaptor jaringan yang mendasar tempat permintaan OID OID_SWITCH_NIC_DISCONNECT dikeluarkan.
  
  Catatan Jika ekstensi yang disebut ReferenceSwitchNic untuk meningkatkan penghitung referensi sakelar yang dapat diperluas sebelum OID_SWITCH_NIC_DISCONNECT dikeluarkan, ekstensi masih dapat meneruskan atau berasal dari permintaan OID.
- Meneruskan atau berasal dari indikasi status NDIS NDIS_STATUS_SWITCH_NIC_STATUS dari adaptor jaringan yang mendasar tempat permintaan OID OID_SWITCH_NIC_DISCONNECT dikeluarkan.
  
  Catatan Jika ekstensi yang disebut ReferenceSwitchNic untuk meningkatkan penghitung referensi sakelar yang dapat diperluas sebelum OID_SWITCH_NIC_DISCONNECT dikeluarkan, ekstensi masih dapat meneruskan atau berasal dari indikasi status NDIS.
  
  Catatan Jika ekstensi sebelumnya disebut ReferenceSwitchNic untuk meningkatkan penghitung referensi switch yang dapat diperluas, ekstensi tidak perlu menyinkronkan panggilannya untuk memulai atau meneruskan permintaan OID atau indikasi status NDIS dengan kodenya yang mengelola permintaan OID sakelar yang dapat diperluas Hyper-V. Setelah ekstensi menaikkan penghitung referensi, antarmuka sakelar yang dapat diperluas tidak akan mengeluarkan permintaan set OID_SWITCH_NIC_DELETE OID.
Ekstensi harus selalu meneruskan permintaan set OID ini ke ekstensi yang mendasar. Ekstensi tidak boleh menyelesaikan permintaan.
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_DISCONNECT OID terpisah. Setiap permintaan set OID menentukan nilai indeks koneksi adaptor jaringan yang berbeda. Untuk informasi selengkapnya tentang nilai indeks ini, lihat Nilai Indeks Adapter Jaringan.

Ekstensi harus mempertahankan status koneksi untuk setiap adaptor fisik yang mendasar. 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_DISCONNECT.

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 kueri OID OID_SWITCH_NIC_DISCONNECT dan mengembalikan kode status berikut.