OID_QOS_PARAMETERS
Komponen Data Center Bridging (DCB) (Msdcb.sys) mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_QOS_PARAMETERS untuk mengonfigurasi parameter Kualitas Layanan (QoS) NDIS lokal pada adaptor jaringan.
Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_QOS_PARAMETERS .
Catatan Permintaan metode OID ini wajib untuk driver miniport yang mendukung NDIS QoS untuk antarmuka IEEE 802.1 Data Center Bridging (DCB).
Keterangan
Driver Miniport mendapatkan parameter QoS NDIS lokal melalui permintaan metode OID OID_QOS_PARAMETERS. Parameter ini menentukan bagaimana adaptor jaringan memprioritaskan pengiriman, atau keluar, paket. Untuk informasi selengkapnya tentang parameter ini, lihat Gambaran Umum Parameter QoS NDIS.
Catatan Hanya komponen DCB yang dapat mengeluarkan permintaan metode OID OID_QOS_PARAMETERS. Protokol yang terlalu berlebihan atau driver filter tidak boleh mengeluarkan OID ini. Untuk informasi selengkapnya tentang komponen DCB, lihat Arsitektur QoS NDIS untuk Bridging Pusat Data.
Komponen DCB mengeluarkan permintaan OID_QOS_PARAMETERS dalam kondisi berikut:
Administrator sistem menginstal atau menghapus instalan fitur server Microsoft DCB.
Untuk informasi selengkapnya tentang fitur server DCB, lihat Komponen DCB yang Disediakan Sistem.
Administrator sistem mengaktifkan atau menonaktifkan fitur server DCB saat fitur masih diinstal.
Administrator sistem mengubah salah satu parameter fitur server DCB.
Sistem operasi dimulai atau dimulai ulang saat fitur server DCB diinstal.
Ketika driver miniport menangani permintaan metode OID OID_QOS_PARAMETERS, driver miniport harus mengikuti panduan berikut:
Driver miniport menyalin data dalam struktur NDIS_QOS_PARAMETERS ke cache parameter QoS NDIS lokalnya. Driver kemudian menyelesaikan parameter QoS NDIS operasionalnya berdasarkan cache parameter QoS NDIS lokal dan cache parameter QoS NDIS yang diterimanya dari peer jarak jauh.
Untuk informasi selengkapnya tentang cara driver miniport menyelesaikan parameter operasionalnya, lihat Menyelesaikan Parameter QoS NDIS Operasional.
Driver miniport tidak boleh memodifikasi data apa pun yang terkandung dalam struktur NDIS_QOS_PARAMETERS . Driver harus menyelesaikan permintaan metode OID dan mengembalikan data asli dalam struktur NDIS_QOS_PARAMETERS .
Bendera NDIS_QOS_PARAMETERS_WILLING menentukan apakah driver miniport mengaktifkan atau menonaktifkan status Willing Data Center Bridging Exchange (DCBX) lokal. Driver menangani bendera ini dengan cara berikut:
Jika bendera ini diatur, driver miniport harus mengaktifkan status DCBX Willing lokal. Ini memungkinkan driver untuk dikonfigurasi dari jarak jauh dengan pengaturan QoS. Dalam hal ini, driver menyelesaikan parameter QoS operasionalnya berdasarkan parameter QoS jarak jauh. Driver miniport juga dapat menyelesaikan parameter QoS operasionalnya berdasarkan pengaturan QoS kepemilikan apa pun yang ditentukan oleh vendor perangkat keras independen (IHV).
Jika bendera ini tidak diatur, driver miniport harus menonaktifkan status DCBX Willing lokal. Ini memungkinkan driver untuk menyelesaikan parameter QoS operasionalnya dari parameter QoS lokalnya alih-alih parameter QoS jarak jauh. Driver miniport juga harus menonaktifkan atau mengambil alih parameter QoS lokal yang bendera NDIS_QOS_PARAMETERS_Xxx_CONFIGURED terkait tidak diatur.
Misalnya, driver miniport dapat mengambil alih parameter QoS lokal yang tidak dikonfigurasi dengan pengaturan kepemilikannya untuk parameter QoS yang ditentukan oleh IHV. Jika tidak ada pengaturan kepemilikan untuk parameter QoS lokal yang tidak ditentukan dengan bendera NDIS_QOS_PARAMETERS_Xxx_CONFIGURED , driver harus menonaktifkan penggunaan parameter QoS ini pada adaptor jaringan.
Catatan Driver juga dapat mengambil alih parameter QoS lokal yang dikonfigurasi jika mereka membahayakan parameter QoS yang digunakan oleh protokol atau teknologi yang diaktifkan pada adaptor jaringan. Misalnya, driver dapat mengambil alih parameter QoS lokal jika adaptor jaringan diaktifkan untuk boot jarak jauh melalui protokol Fibre Channel over Ethernet (FCoE).
Untuk informasi selengkapnya tentang status DCBX Willing lokal, lihat Mengelola Status DCBX Lokal yang Bersedia.
Untuk informasi selengkapnya tentang bagaimana driver miniport mengambil alih parameter QoS lokal, lihat Mengelola Parameter QoS NDIS.
Catatan Mengesampingkan parameter QoS lokal seharusnya tidak menyebabkan driver miniport gagal dalam permintaan metode OID OID_QOS_PARAMETERS.
Untuk informasi selengkapnya tentang cara driver miniport mengelola parameter QoS lokal, lihat Mengatur Parameter QoS NDIS Lokal.
Mengembalikan Kode Status
Driver miniport mengembalikan salah satu kode status berikut.
Kode Status | Deskripsi |
---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
NDIS_STATUS_PENDING |
Permintaan OID tertunda penyelesaiannya. Ketika driver miniport memanggil NdisMOidRequestComplete, NDIS akan meneruskan kode status akhir dan hasil ke handler penyelesaian permintaan OID dari pemanggil setelah permintaan selesai. |
NDIS_STATUS_NOT_SUPPORTED |
Driver miniport tidak mendukung antarmuka QoS NDIS. |
NDIS_STATUS_INVALID_PARAMETER |
Satu atau beberapa anggota struktur NDIS_QOS_PARAMETERS berisi nilai yang salah. |
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. |
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