OID_NIC_SWITCH_ENUM_SWITCHES
Driver yang terlalu besar atau aplikasi mode pengguna mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_NIC_SWITCH_ENUM_SWITCHES untuk mendapatkan array. Setiap elemen dalam array menentukan atribut sakelar NIC yang telah dibuat pada adaptor jaringan.
Setelah pengembalian berhasil dari permintaan kueri OID ini, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer yang berisi berikut ini:
Struktur NDIS_NIC_SWITCH_INFO_ARRAY yang menentukan jumlah elemen dalam array.
Array struktur NDIS_NIC_SWITCH_INFO . Masing-masing struktur ini berisi informasi tentang satu sakelar NIC yang dibuat pada adaptor jaringan.
Catatan Jika adaptor jaringan tidak memiliki sakelar NIC, driver mengatur anggota NumElements dari struktur NDIS_NIC_SWITCH_INFO_ARRAY ke nol dan tidak ada struktur NDIS_NIC_SWITCH_INFO yang dikembalikan.
Keterangan
Driver yang terlalu besar dan aplikasi mode pengguna mengeluarkan permintaan kueri OID OID_NIC_SWITCH_ENUM_SWITCHES untuk menghitung sakelar NIC yang dibuat pada adaptor jaringan.
Catatan Dimulai dengan Windows Server 2012, antarmuka virtualisasi I/O root tunggal (SR-IOV) hanya mendukung sakelar NIC default pada adaptor jaringan. Oleh karena itu, struktur NDIS_NIC_SWITCH_INFO_ARRAY yang dikembalikan harus menentukan elemen NDIS_NIC_SWITCH_INFO tunggal untuk sakelar NIC default, yang direferensikan oleh pengidentifikasi NDIS_DEFAULT_SWITCH_ID.
Mengembalikan Kode Status
NDIS menangani permintaan kueri OID dari permintaan OID_NIC_SWITCH_ENUM_SWITCHES untuk driver miniport. Driver tidak akan dikeluarkan permintaan OID ini.
Saat NDIS menangani permintaan OID_NIC_SWITCH_ENUM_SWITCHES, NDIS mengembalikan salah satu kode status berikut.
Kode Status | Deskripsi |
---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
NDIS_STATUS_NOT_SUPPORTED |
Driver miniport tidak mendukung antarmuka SR-IOV atau tidak diaktifkan untuk menggunakan antarmuka. |
NDIS_STATUS_INVALID_PARAMETER |
Satu atau beberapa anggota struktur NDIS_NIC_SWITCH_INFO_ARRAY memiliki nilai yang tidak valid. |
NDIS_STATUS_INVALID_LENGTH |
Buffer informasi terlalu pendek. NDIS 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk