OID_QOS_HARDWARE_CAPABILITIES

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_QOS_HARDWARE_CAPABILITIES untuk mendapatkan kemampuan perangkat keras NDIS Quality of Service (QoS) dari adaptor jaringan.

Setelah berhasil mengembalikan dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_QOS_CAPABILITIES .

Catatan Permintaan kueri OID ini ditangani oleh NDIS untuk driver miniport yang mendukung antarmuka IEEE 802.1 Data Center Bridging (DCB).

Keterangan

Struktur NDIS_QOS_CAPABILITIES berisi informasi tentang kemampuan perangkat keras QoS NDIS 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 perangkat keras QoS NDIS adaptor jaringan dikembalikan melalui permintaan kueri OID OID_QOS_HARDWARE_CAPABILITIES, terlepas dari apakah kemampuan diaktifkan atau dinonaktifkan.

Driver Miniport mendaftarkan kemampuan perangkat keras QoS NDIS dari adaptor jaringan ketika fungsi MiniportInitializeEx-nya dipanggil. Driver mendaftarkan kemampuan ini dengan mengikuti langkah-langkah berikut:

Driver menginisialisasi struktur NDIS_QOS_CAPABILITIES dengan kemampuan perangkat keras QoS NDIS.
Driver mengatur anggota HardwareQosCapabilities dari struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES ke penunjuk ke struktur NDIS_QOS_CAPABILITIES .
Driver miniport kemudian memanggil fungsi NdisMSetMiniportAttributes dan mengatur parameter MiniportAttributes ke penunjuk ke struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Catatan NDIS tidak melaporkan kemampuan perangkat keras NDIS QoS dari adaptor jaringan ke protokol yang terlalu mengandalkan dan memfilter driver selama operasi ikat atau lampirkan.

Untuk informasi selengkapnya tentang cara mendaftarkan kemampuan QoS NDIS, lihat Mendaftarkan Kemampuan QoS NDIS.

Mengembalikan Kode Status

NDIS menangani permintaan kueri OID dari permintaan OID_QOS_HARDWARE_CAPABILITIES untuk driver miniport, dan 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 NDIS QoS.
NDIS_STATUS_INVALID_LENGTH	Panjang buffer informasi kurang dari sizeof(NDIS_QOS_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.