OID_QOS_OPERATIONAL_PARAMETERS

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_QOS_OPERATIONAL_PARAMETERS untuk mendapatkan parameter operasional NDIS Quality of Service (QoS) saat ini untuk adaptor jaringan. Driver miniport mengonfigurasi adaptor jaringan dengan parameter QoS NDIS operasional untuk melakukan transmisi paket QoS.

Setelah pengembalian berhasil dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_QOS_PARAMETERS .

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

Keterangan

Ketika NDIS menangani permintaan kueri OID OID_QOS_OPERATIONAL_PARAMETERS berhasil, NDIS QoS parameter operasional yang telah di-cache dari indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE sebelumnya yang dikeluarkan oleh driver miniport. Driver mengeluarkan indikasi status ini untuk melaporkan set awal parameter QoS NDIS operasional. Driver juga mengeluarkan indikasi status ini setiap kali parameter QoS NDIS operasional berubah.

NDIS mengembalikan struktur NDIS_QOS_PARAMETERS yang diinisialisasi dengan cara berikut:

Jika driver miniport sebelumnya mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE , NDIS menyimpan data NDIS_QOS_PARAMETERS dan mengembalikan data ini untuk permintaan kueri OID OID_QOS_OPERATIONAL_PARAMETERS.
Jika driver miniport tidak mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE , NDIS mengembalikan struktur NDIS_QOS_PARAMETERS dengan semua anggota (dengan pengecualian anggota Header ) diatur ke nol.

Untuk informasi selengkapnya tentang parameter QoS NDIS operasional, lihat Gambaran Umum Parameter QoS NDIS.

Mengembalikan Kode Status

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 QoS NDIS.
NDIS_STATUS_INVALID_LENGTH	Panjang buffer informasi kurang dari sizeof(NDIS_QOS_PARAMETERS). 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.