OID_SWITCH_PARAMETERS
Ekstensi sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan kueri pengidentifikasi objek (OID) dari OID_SWITCH_PARAMETERS untuk mendapatkan data konfigurasi sakelar yang dapat diperluas.
Jika permintaan kueri OID berhasil diselesaikan, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SWITCH_PARAMETERS .
Keterangan
Ketika ekstensi memproses struktur NDIS_SWITCH_PARAMETERS yang dikembalikan, ekstensi tidak boleh berasumsi bahwa berbagai anggota string dari struktur NDIS_SWITCH_PARAMETERS , seperti SwitchName, dihentikan null. Jenis data untuk anggota string ini ditentukan oleh struktur IF_COUNTED_STRING . Ekstensi 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_PARAMETERS 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 struktur OID_SWITCH_PARAMETERS untuk permintaan kueri OID. 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) |