OID_SWITCH_PORT_ARRAY

Ekstensi sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_SWITCH_PORT_ARRAY untuk mendapatkan array. Setiap elemen dalam array menentukan parameter konfigurasi untuk port sakelar yang dapat diperluas.

Jika permintaan kueri OID berhasil diselesaikan, InformationBuffer anggota struktur NDIS_OID_REQUEST berisi pointer ke buffer. Buffer ini berisi data berikut:

• Struktur NDIS_SWITCH_PORT_ARRAY yang menentukan jumlah elemen dalam array.

• Array struktur NDIS_SWITCH_PORT_PARAMETERS. Masing-masing struktur ini berisi informasi tentang port pada sakelar yang dapat diperluas.

  Catatan Jika tidak ada port yang dibuat pada sakelar yang dapat diperluas, driver mengatur NumElements anggota struktur NDIS_SWITCH_PORT_ARRAY menjadi nol dan tidak ada struktur NDIS_SWITCH_PORT_PARAMETERS yang dikembalikan.

Komentar

OID OID_SWITCH_PORT_ARRAY 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.

Saat ekstensi menangani struktur NDIS_SWITCH_PORT_PARAMETERS yang dikembalikan, ekstensi tidak boleh mengasumsikan bahwa berbagai anggota string dari struktur NDIS_SWITCH_PORT_PARAMETERS, seperti PortName, dihentikan null. Jenis data untuk anggota string ini ditentukan oleh struktur IF_COUNTED_STRING. Driver harus menentukan panjang string dari nilai Panjang anggota struktur ini.

Catatan Jika string dihentikan null, anggota Panjang tidak boleh menyertakan karakter null yang mengakhiri.

Mengembalikan Kode Status

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

Kode Status	Deskripsi
NDIS_STATUS_SUCCESS	Permintaan OID berhasil diselesaikan.
NDIS_STATUS_INVALID_LENGTH	Panjang buffer informasi terlalu kecil untuk mengembalikan NDIS_SWITCH_PORT_ARRAY dan array elemen NDIS_SWITCH_PORT_PARAMETERS. Tepi miniport yang mendasar dari sakelar yang dapat diperluas mengatur data . QUERY_INFORMATION. BytesNeeded anggota dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.
NDIS_STATUS_FAILURE	Permintaan gagal karena alasan lain.

Persyaratan

Versi	Didukung di NDIS 6.30 dan yang lebih baru.
Header	Ntddndis.h (termasuk Ndis.h)

Lihat juga

---

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

Mengkueri Konfigurasi Sakelar yang Dapat Diperluas Hyper-V