OID_SWITCH_PORT_TEARDOWN

Artikel
06/14/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_PORT_TEARDOWN untuk memberi tahu ekstensi sakelar yang dapat diperluas yang mendasar bahwa port sakelar yang dapat diperluas akan memulai proses penghapusan. Proses ini dimulai ketika driver protokol mengeluarkan permintaan set OID_SWITCH_PORT_DELETE OID.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SWITCH_PORT_PARAMETERS .

Keterangan

Anggota PortId dari struktur NDIS_SWITCH_PORT_PARAMETERS menentukan port sakelar yang dapat diperluas tempat pemberitahuan koneksi dibuat. Ekstensi sakelar yang dapat diperluas harus memperbarui informasi yang di-cache tentang port yang diperolehnya 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 diatur ke TRUE. Jika IsActive FALSE, ekstensi mengeluarkan OID saat NET_PNP_EVENT NetEventSwitchActivate dikeluarkan oleh miniport ekstensi.
Dengan memeriksa berbagai OID menetapkan permintaan OID_SWITCH_PORT_CREATE dan OID_SWITCH_PORT_DELETE.

Tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan set OID OID_SWITCH_PORT_TEARDOWN untuk memberi tahu ekstensi bahwa port sedang dalam proses dihapus dari sakelar yang dapat diperluas. Sebelum permintaan OID ini dikeluarkan, tepi protokol sakelar yang dapat diperluas sebelumnya telah mengeluarkan OID berikut jika port memiliki koneksi adaptor jaringan aktif:

OID_SWITCH_NIC_DISCONNECT, yang memberi tahu ekstensi yang mendasar bahwa adaptor jaringan tidak lagi terhubung ke port yang ditentukan dalam struktur NDIS_SWITCH_PORT_PARAMETERS .
OID_SWITCH_NIC_DELETE, yang memberi tahu ekstensi yang mendasar bahwa koneksi jaringan antara adaptor jaringan dan port sakelar yang dapat diperluas telah dihapus.

Tepi protokol mengeluarkan permintaan set OID ini setelah semua paket yang tertunda untuk port sakelar yang dapat diperluas yang ditentukan telah dibatalkan atau selesai.

Setelah ekstensi menyelesaikan permintaan set OID ini dan penghitung referensi untuk port sakelar yang dapat diperluas adalah nol, tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan set OID OID_SWITCH_PORT_DELETE. Permintaan OID ini menghapus port dari sakelar yang dapat diperluas.

Catatan Ekstensi meningkatkan penghitung referensi untuk port sakelar yang dapat diperluas dengan memanggil ReferenceSwitchPort. Ekstensi mengurangi penghitung referensi dengan memanggil DereferenceSwitchPort.

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

Ekstensi harus selalu meneruskan permintaan set OID ini ke ekstensi yang mendasar. Ekstensi tidak boleh gagal dalam permintaan.

Catatan Ekstensi tidak boleh mengubah struktur NDIS_SWITCH_PORT_PARAMETERS yang terkait dengan permintaan OID.
Setelah ekstensi meneruskan permintaan OID ini, ekstensi tidak dapat meneruskan paket ke port yang dihapus. Ekstensi juga tidak dapat mengeluarkan permintaan OID atau memanggil fungsi ReferenceSwitchPort untuk port yang dihapus.

Catatan Ekstensi tidak boleh mengeluarkan permintaan set OID OID_SWITCH_PORT_TEARDOWN.

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_PORT_TEARDOWN dan mengembalikan kode status berikut.