OID_SWITCH_PORT_CREATE

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_PORT_CREATE untuk memberi tahu ekstensi sakelar yang dapat diperluas tentang pembuatan 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 tempat pemberitahuan pembuatan dibuat.

Ekstensi sakelar yang dapat diperluas harus mengikuti panduan ini untuk menangani permintaan set OID OID_SWITCH_PORT_CREATE:

Ekstensi tidak boleh mengubah struktur NDIS_SWITCH_PORT_PARAMETERS yang terkait dengan permintaan OID.
Ekstensi dapat mem-veto pemberitahuan pembuatan dengan mengembalikan NDIS_STATUS_DATA_NOT_ACCEPTED untuk permintaan OID. Misalnya, jika ekstensi tidak dapat mengalokasikan sumber daya untuk menerapkan kebijakan yang dikonfigurasi pada port, driver harus mem-veto pemberitahuan pembuatan.

Jika ekstensi mengembalikan kode status kesalahan 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.

Untuk informasi selengkapnya tentang kebijakan port, lihat Mengelola Kebijakan Sakelar yang Dapat Diperluas Hyper-V.
Jika ekstensi memanggil NdisFOidRequest untuk meneruskan permintaan set OID ini, 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 port.
Setelah permintaan OID diteruskan dan berhasil diselesaikan, ekstensi dapat mengeluarkan permintaan OID untuk port, seperti OID_SWITCH_PORT_PROPERTY_ENUM, hingga permintaan OID OID_SWITCH_PORT_TEARDOWN dikeluarkan. Permintaan OID ini memberi tahu ekstensi bahwa port akan memulai proses penghapusan dari sakelar yang dapat diperluas.
Ekstensi tidak dapat meneruskan paket ke port yang ditentukan dalam struktur NDIS_SWITCH_PORT_PARAMETERS hingga permintaan set OID_SWITCH_NIC_CONNECT OID dikeluarkan dan berhasil diselesaikan.

Catatan Ekstensi tidak boleh mengeluarkan permintaan set OID OID_SWITCH_PORT_CREATE.

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

Jika ekstensi menyelesaikan permintaan set OID_SWITCH_PORT_CREATE OID, 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_PORT_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.