OID_QOS_REMOTE_PARAMETERS

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan kueri pengidentifikasi objek (OID) dari OID_QOS_REMOTE_PARAMETERS untuk mendapatkan parameter NDIS Quality of Service (QoS) untuk peer jarak jauh. Driver miniport menggunakan parameter QoS jarak jauh ini untuk menyelesaikan parameter QoS NDIS operasionalnya. Driver mengonfigurasi adaptor jaringan dengan parameter operasional untuk melakukan transmisi paket QoS.

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

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

Keterangan

Ketika NDIS menangani permintaan OID OID_QOS_REMOTE_PARAMETERS berhasil, NDIS QoS jarak jauh mengembalikan parameter QoS NDIS jarak jauh yang telah di-cache dari indikasi status NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE sebelumnya yang dikeluarkan oleh driver miniport. Driver mengeluarkan indikasi status ini untuk melaporkan kumpulan awal parameter QoS NDIS jarak jauh. Driver juga mengeluarkan indikasi status ini setiap kali parameter QoS NDIS jarak jauh berubah.

NDIS mengembalikan struktur NDIS_QOS_PARAMETERS yang diinisialisasi dengan cara berikut:

Jika driver miniport sebelumnya mengeluarkan indikasi status NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE , NDIS menyimpan data NDIS_QOS_PARAMETERS dan mengembalikan data ini untuk permintaan kueri OID OID_QOS_REMOTE_PARAMETERS.
Jika driver miniport tidak mengeluarkan indikasi status NDIS_STATUS_QOS_REMOTE_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 jarak jauh, 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 NDIS QoS.
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.