OID_SWITCH_PORT_PROPERTY_ENUM

Artikel
06/15/2023

Ekstensi sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_SWITCH_PORT_PROPERTY_ENUM untuk mendapatkan array. Array ini berisi kebijakan port yang disediakan yang cocok dengan kriteria yang ditentukan. Setiap elemen dalam array menentukan properti kebijakan untuk port sakelar yang dapat diperluas tertentu.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi data berikut:

Struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS yang menentukan parameter untuk enumerasi kebijakan port tertentu.
Array struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO . Masing-masing struktur ini berisi informasi tentang properti kebijakan port switch yang dapat diperluas.

Catatan Jika anggota NumProperties dari struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS diatur ke nol, tidak ada struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO yang dikembalikan.

Keterangan

Sebelum mengeluarkan permintaan metode OID OID_SWITCH_PORT_PROPERTY_ENUM, ekstensi sakelar yang dapat diperluas harus mengikuti panduan berikut:

Ekstensi hanya dapat mengeluarkan permintaan OID_SWITCH_PORT_PROPERTY_ENUM setelah tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan OID_SWITCH_PORT_CREATE dan sebelum mengeluarkan permintaan OID_SWITCH_PORT_TEARDOWN .
Ekstensi harus memanggil ReferenceSwitchPort sebelum memanggil NdisFOidRequest untuk mengeluarkan permintaan OID_SWITCH_PORT_PROPERTY_ENUM. Ini memastikan bahwa port yang ditentukan tidak akan dihapus sampai setelah permintaan OID selesai.

Setelah permintaan OID selesai, ekstensi harus memanggil DereferenceSwitchPort. Ekstensi harus memanggil fungsi ini terlepas dari apakah permintaan OID selesai dengan NDIS_STATUS_SUCCESS.

OID OID_SWITCH_PORT_PROPERTY_ENUM hanya boleh dikeluarkan ketika sakelar yang dapat diperluas Hyper-V telah menyelesaikan aktivasi. Silakan lihat Mengkueri Konfigurasi Sakelar Yang Dapat Diperluas Hyper-V untuk detail selengkapnya.

Catatan Jika ekstensi menerima permintaan metode OID OID_SWITCH_PORT_PROPERTY_ENUM, ekstensi tidak boleh menyelesaikan permintaan OID. Sebaliknya, ia harus memanggil NdisFOidRequest untuk meneruskan permintaan OID ke tumpukan driver sakelar yang dapat diperluas.

Mengembalikan Kode Status

Tepi miniport yang mendasar dari sakelar yang dapat diperluas menyelesaikan permintaan kueri OID OID_SWITCH_PORT_PROPERTY_ENUM dan mengembalikan kode status berikut.