Share via

OID_SWITCH_NIC_ARRAY

  • Artikel

Ekstensi sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_SWITCH_NIC_ARRAY untuk mendapatkan array. Setiap elemen dalam array menentukan parameter konfigurasi adaptor jaringan virtual yang terkait dengan port sakelar yang dapat diperluas.

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

  • Struktur NDIS_SWITCH_NIC_ARRAY yang menentukan jumlah elemen dalam array. Struktur ini juga menentukan offset ke elemen pertama dalam array.

  • Array struktur NDIS_SWITCH_NIC_PARAMETERS . Masing-masing struktur ini berisi informasi tentang adaptor jaringan yang terhubung ke port sakelar yang dapat diperluas.

    Catatan Jika tidak ada adaptor jaringan yang terhubung ke port sakelar yang dapat diperluas, tepi miniport yang mendasar dari sakelar yang dapat diperluas mengatur anggota NumElements dari struktur NDIS_SWITCH_NIC_ARRAY ke nol. Dalam hal ini, tidak ada struktur NDIS_SWITCH_NIC_PARAMETERS yang dikembalikan.

Keterangan

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

Ketika ekstensi memproses struktur NDIS_SWITCH_NIC_PARAMETERS yang dikembalikan, ekstensi tidak boleh berasumsi bahwa berbagai anggota string dari struktur NDIS_SWITCH_PORT_PARAMETERS , seperti NicFriendlyName, dihentikan NULL. Jenis data untuk anggota string ini ditentukan oleh struktur IF_COUNTED_STRING . Driver harus menentukan panjang string dari nilai anggota Panjang 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_NIC_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_NIC_ARRAY dan array elemen NDIS_SWITCH_NIC_PARAMETERS . Tepi miniport yang mendasar dari sakelar yang dapat diperluas mengatur DATA. QUERY_INFORMATION. Anggota BytesNeeded 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_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

Mengkueri Konfigurasi Sakelar Yang Dapat Diperluas Hyper-V