OID_SWITCH_PORT_DELETE

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_PORT_DELETE untuk memberi tahu ekstensi sakelar yang dapat diperluas tentang penghapusan port sakelar yang dapat diperluas.

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 penghapusan dibuat.

Jika adaptor jaringan tersambung ke port yang ditentukan, tepi protokol sakelar yang dapat diperluas akan menghapus koneksi sebelum menghapus port. Dalam hal ini, tepi protokol akan mengikuti langkah-langkah ini sebelum menghapus port:

Tepi protokol mengeluarkan permintaan set OID_SWITCH_NIC_DISCONNECT OID untuk memberi tahu ekstensi bahwa koneksi antara adaptor jaringan dan port sakelar yang dapat diperluas sedang dihapus.
Setelah semua paket yang tertunda untuk port sakelar yang dapat diperluas yang ditentukan telah dibatalkan atau selesai, tepi protokol mengeluarkan permintaan set OID_SWITCH_NIC_DELETE OID untuk memberi tahu ekstensi bahwa koneksi antara adaptor jaringan dan port sakelar yang dapat diperluas telah dihapus.

Pada titik ini, tepi protokol dapat mulai menghapus port.

Tepi protokol sakelar yang dapat diperluas mengikuti langkah-langkah ini ketika menghapus port sakelar yang dapat diperluas:

Tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan set OID_SWITCH_PORT_TEARDOWN OID. Permintaan OID ini memberi tahu ekstensi sakelar yang dapat diperluas tentang awal proses penghapusan untuk port sakelar yang dapat diperluas.
Tepi protokol mengeluarkan permintaan set OID_SWITCH_PORT_DELETE OID setelah semua permintaan OID ke port sakelar yang dapat diperluas telah selesai.

Catatan Jika ekstensi sebelumnya disebut ReferenceSwitchPort untuk menambah penghitung referensi port, ekstensi harus memanggil DereferenceSwitchPort sebelum tepi protokol mengeluarkan permintaan OID_SWITCH_NIC_DELETE .

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

Ekstensi tidak boleh mengubah struktur NDIS_SWITCH_PORT_PARAMETERS yang terkait dengan permintaan OID.
Ekstensi harus selalu meneruskan permintaan set OID ini ke ekstensi yang mendasar. Ekstensi tidak boleh gagal dalam permintaan.
Setelah permintaan OID_SWITCH_PORT_DELETE selesai dengan NDIS_STATUS_SUCCESS, ekstensi tidak akan menerima paket atau permintaan OID untuk port yang dihapus. 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 sakelar yang dapat diperluas tidak boleh mengeluarkan permintaan set OID_SWITCH_PORT_DELETE OID.

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