OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Driver yang terlalu berlebihan mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_NIC_SWITCH_HARDWARE_CAPABILITIES untuk mendapatkan kemampuan perangkat keras sakelar NIC di adaptor jaringan.
Setelah pengembalian berhasil dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES .
Keterangan
Struktur NDIS_NIC_SWITCH_CAPABILITIES berisi informasi tentang kemampuan perangkat keras sakelar NIC pada adaptor jaringan. Kemampuan ini dapat mencakup kemampuan perangkat keras yang saat ini dinonaktifkan oleh pengaturan file INF atau melalui halaman Properti tingkat lanjut .
Catatan Semua kemampuan sakelar NIC yang ditentukan dikembalikan melalui permintaan kueri OID OID_NIC_SWITCH_HARDWARE_CAPABILITIES, terlepas dari apakah kemampuan diaktifkan atau dinonaktifkan.
Dimulai dengan NDIS 6.20, driver miniport menyediakan kemampuan perangkat keras sakelar NIC ketika fungsi MiniportInitializeEx-nya dipanggil. Driver menginisialisasi struktur NDIS_NIC_SWITCH_CAPABILITIES dengan kemampuan perangkat keras sakelar NIC dan mengatur anggota HardwareNicSwitchCapabilities dari struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES ke penunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES . Driver miniport kemudian memanggil fungsi NdisMSetMiniportAttributes dan mengatur parameter MiniportAttributes ke penunjuk ke struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
Catatan Dimulai dengan NDIS 6.30, driver miniport yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV) harus mendaftarkan kemampuan perangkat keras dari sakelar NIC. Driver mendaftarkan kemampuan ini dengan memanggil NdisMSetMiniportAttributes.
Mengembalikan Kode Status
NDIS menangani permintaan kueri OID dari permintaan OID_NIC_SWITCH_HARDWARE_CAPABILITIES untuk driver miniport, dan mengembalikan salah satu kode status berikut:
| Kode Status | Deskripsi |
|---|---|
NDIS_STATUS_SUCCESS |
Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
Driver miniport tidak mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV) atau tidak diaktifkan untuk menggunakan antarmuka. |
NDIS_STATUS_INVALID_LENGTH |
Panjang buffer informasi kurang dari sizeof(NDIS_NIC_SWITCH_CAPABILITIES). 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.20 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk