Mengkueri Konfigurasi Sakelar yang Dapat Diperluas Hyper-V

Antarmuka sakelar yang dapat diperluas Hyper-V mencakup permintaan pengidentifikasi objek (OID) yang dikeluarkan oleh ekstensi sakelar yang dapat diperluas untuk mengkueri konfigurasi sakelar yang dapat diperluas saat ini, portnya, dan koneksi adaptor jaringannya. Permintaan ini mencakup OID berikut:

OID_SWITCH_NIC_ARRAY
Permintaan kueri OID ini mengembalikan array. Setiap elemen dalam array menentukan parameter konfigurasi adaptor jaringan yang terkait dengan port sakelar yang dapat diperluas.

OID_SWITCH_PARAMETERS
Permintaan kueri OID ini mengembalikan konfigurasi sakelar yang dapat diperluas saat ini.

OID_SWITCH_PORT_ARRAY
Permintaan kueri OID ini mengembalikan array. Setiap elemen dalam array menentukan parameter konfigurasi untuk port sakelar yang dapat diperluas.

OID_SWITCH_PORT_PROPERTY_ENUM
Permintaan metode OID ini mengembalikan array. Setiap elemen dalam array menentukan properti kebijakan untuk port sakelar yang dapat diperluas tertentu.

OID_SWITCH_PROPERTY_ENUM
Permintaan metode OID ini mengembalikan array. Setiap elemen dalam array menentukan sifat-sifat dari kebijakan sakelar yang dapat diperluas.

Catatan Saat ekstensi sakelar mengikat untuk Sakelar Ekstensi Hyper-v, ekstensi harus terlebih dahulu mengeluarkan OID_SWITCH_PARAMETERS OID untuk mendapatkan informasi sakelar dasar. Jika anggota IsActive dari struktur NDIS_SWITCH_PARAMETERS adalah FALSE, ekstensi tidak boleh mengeluarkan OID kueri lain sampai saklar selesai aktivasi. Dalam hal ini, pemberitahuan NET_PNP_EVENTNetEventSwitchActivate menentukan peristiwa aktivasi switch. Jika anggota IsActive TRUE saat penyambungan, ekstensi dapat dengan aman mengeluarkan OID permintaan lainnya. Mengkueri konfigurasi sementara Hyper-v Extensible Switch belum menyelesaikan aktivasi akan mengakibatkan ekstensi memiliki tampilan awal konfigurasi pengalihan yang tidak lengkap.

Note Ketika ekstensi menghasilkan permintaan OID sendiri, ekstensi melakukan ini dengan cara yang sama seperti driver filter NDIS apa pun. Untuk informasi selengkapnya tentang bagaimana hal ini dilakukan, lihat Menghasilkan Permintaan OID dari Driver Filter NDIS.

Untuk informasi selengkapnya tentang jalur kontrol sakelar yang dapat diperluas untuk permintaan OID, lihat Hyper-V Jalur Kontrol Sakelar yang Dapat Diperluas untuk Permintaan OID.