OID_SWITCH_NIC_DELETE

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_DELETE ke tumpukan driver sakelar yang dapat diperluas. Permintaan OID ini memberi tahu ekstensi sakelar yang dapat diperluas tentang penghapusan koneksi antara port sakelar yang dapat diperluas dan adaptor jaringan. Tepi protokol sakelar yang dapat diperluas sebelumnya memberi tahu ekstensi bahwa koneksi ini sedang dihapus ketika mengeluarkan permintaan set OID OID_SWITCH_NIC_DISCONNECT.

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

Sebelum tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan OID_SWITCH_NIC_DELETE, ia menjamin bahwa semua permintaan kirim atau terima paket yang tertunda untuk koneksi adaptor jaringan yang ditentukan telah selesai. Tepi protokol juga menjamin bahwa semua permintaan OID yang tertunda untuk koneksi adaptor telah selesai, dan penghitung referensi sakelar yang dapat diperluas untuk koneksi adaptor memiliki nilai nol.

Catatan Jika ekstensi telah meningkatkan penghitung referensi sakelar yang dapat diperluas untuk adaptor jaringan dengan memanggil ReferenceSwitchNic, permintaan OID_SWITCH_NIC_DELETE tidak dikeluarkan saat penghitung referensi bukan nol. Ekstensi mengurangi penghitung referensi sakelar yang dapat diperluas dengan memanggil DereferenceSwitchNic.

Ekstensi harus mengikuti panduan ini untuk menangani permintaan OID_SWITCH_NIC_DELETE 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_DELETE.
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_DELETE 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.

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