OID_SWITCH_NIC_CREATE

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_CREATE untuk memberi tahu ekstensi sakelar yang dapat diperluas yang mendasar bahwa koneksi baru sedang dibuat antara port sakelar yang dapat diperluas dan adaptor jaringan eksternal atau virtual. Setelah koneksi sepenuhnya dibuat, tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan set OID OID_SWITCH_NIC_CONNECT.

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 tempat pemberitahuan pembuatan dibuat. Ekstensi sakelar yang dapat diperluas dapat memperoleh informasi parameter untuk 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 pembuatan 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.

Ketika menerima permintaan set OID OID_SWITCH_NIC_CREATE, ekstensi harus mengikuti panduan berikut:

Ekstensi tidak boleh mengubah struktur NDIS_SWITCH_NIC_PARAMETERS yang terkait dengan permintaan OID.
Permintaan OID_SWITCH_NIC_CREATE hanya memberi tahu ekstensi bahwa koneksi sakelar yang dapat diperluas baru sedang dimunculkan dan lalu lintas paket tersebut mungkin segera mulai terjadi melalui port yang ditentukan. Namun, ekstensi tidak dapat menggunakan port sampai tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan set OID OID_SWITCH_NIC_CONNECT. Sampai OID dikeluarkan, ekstensi tidak boleh melakukan hal berikut:
- Hasilkan lalu lintas paket apa pun ke koneksi adaptor jaringan pada port sakelar yang dapat diperluas yang permintaan OID OID_SWITCH_NIC_CREATE dikeluarkan.
- Meneruskan atau memulai permintaan OID OID_SWITCH_NIC_REQUEST ke adaptor jaringan yang mendasar tempat permintaan OID OID_SWITCH_NIC_CREATE dikeluarkan.
- Meneruskan atau memulai indikasi status NDIS NDIS_STATUS_SWITCH_NIC_STATUS dari adaptor jaringan yang mendasar tempat permintaan OID OID_SWITCH_NIC_CREATE dikeluarkan.
- Panggil ReferenceSwitchNic untuk menambah penghitung referensi sakelar yang dapat diperluas untuk koneksi adaptor jaringan yang ditentukan pada port sakelar yang dapat diperluas.
Catatan Ekstensi dapat mencegat kirim atau terima paket untuk port yang ditentukan antara permintaan OID OID_SWITCH_NIC_CREATE dan OID_SWITCH_NIC_CONNECT. Dalam hal ini, ekstensi harus meneruskan permintaan kirim atau terima paket alih-alih membatalkannya.
Ekstensi dapat mem-veto pemberitahuan pembuatan dengan mengembalikan NDIS_STATUS_DATA_NOT_ACCEPTED untuk permintaan OID. Misalnya, jika ekstensi tidak dapat memenuhi kebijakan yang dikonfigurasi pada port yang ditentukan, ekstensi harus mem-veto pemberitahuan pembuatan.

Jika ekstensi mengembalikan kode status NDIS_STATUS_Xxx lainnya , pemberitahuan pembuatan juga di-veto. Namun, mengembalikan kode status untuk skenario transitori, seperti mengembalikan NDIS_STATUS_RESOURCES, dapat mengakibatkan coba lagi pemberitahuan pembuatan.

Jika ekstensi tidak mem-veto permintaan OID, ekstensi harus memantau status ketika permintaan selesai. Ekstensi harus melakukan ini untuk menentukan apakah permintaan OID di-veto dengan ekstensi yang mendasar di jalur kontrol sakelar yang dapat diperluas atau oleh antarmuka sakelar yang dapat diperluas.

Catatan Ekstensi hanya dapat mem-veto permintaan OID jika anggota Indeks dari struktur NDIS_SWITCH_NIC_PARAMETERS menentukan nilai indeks adaptor jaringan nol.
Jika ekstensi tidak mem-veto pemberitahuan pembuatan, ekstensi harus memanggil NdisFOidRequest untuk meneruskan permintaan OID ini ke ekstensi yang mendasar di tumpukan driver sakelar yang dapat diperluas.

Catatan Ekstensi harus memantau status penyelesaian permintaan OID ini. Ekstensi melakukan ini untuk mendeteksi apakah ekstensi yang mendasar dalam tumpukan driver sakelar yang dapat diperluas telah mem-veto pemberitahuan pembuatan.
Jika ekstensi memanggil NdisFOidRequest untuk meneruskan permintaan OID ini, ekstensi tidak akan segera menerima lalu lintas paket apa pun ke atau dari port sakelar yang dapat diperluas. Selain itu, ekstensi tidak dapat segera menyuntikkan kirim atau terima lalu lintas untuk port sakelar yang dapat diperluas.
Ekstensi hanya dapat meneruskan lalu lintas paket ke port sakelar yang dapat diperluas setelah tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan set OID OID_SWITCH_NIC_CONNECT.

Catatan Dalam beberapa situasi, lalu lintas paket dapat diteruskan oleh sakelar yang dapat diperluas ke port sebelum permintaan set OID OID_SWITCH_NIC_CONNECT dikeluarkan.
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 terpisah dari OID_SWITCH_NIC_CREATE. 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.

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

Mengembalikan Kode Status

Jika ekstensi menyelesaikan permintaan set OID OID_SWITCH_NIC_CREATE, ekstensi mengembalikan salah satu kode status berikut.

Kode Status	Deskripsi
NDIS_STATUS_DATA_NOT_ACCEPTED	Ekstensi mem-veto pemberitahuan pembuatan.
NDIS_STATUS_RESOURCES	Ekstensi mem-veto pemberitahuan pembuatan karena kondisi sumber daya yang rendah.
NDIS_STATUS_Xxx	Ekstensi mem-veto pemberitahuan pembuatan karena alasan lain.

Catatan Jika ekstensi menyelesaikan permintaan set OID, ekstensi tidak boleh mengembalikan NDIS_STATUS_SUCCESS.

Jika ekstensi tidak menyelesaikan permintaan set OID OID_SWITCH_NIC_CREATE, permintaan diselesaikan oleh tepi miniport yang mendasar dari sakelar yang dapat diperluas. Tepi miniport yang mendasar mengembalikan kode status berikut untuk permintaan set OID ini: