Menunjukkan Perubahan pada Parameter QoS NDIS Operasional

Driver miniport yang mendukung NDIS Quality of Service (QoS) mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE ketika parameter QoS NDIS operasional driver diselesaikan untuk pertama kalinya atau ketika mereka berubah nanti. Driver miniport mengonfigurasi adaptor jaringan dengan parameter operasional ini untuk melakukan transmisi paket QoS.

Driver miniport harus mengikuti panduan ini untuk mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE :

• Driver miniport harus mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE setelah menyelesaikan parameter QoS NDIS operasionalnya dan mengonfigurasi adaptor jaringan dengannya.

  Catatan Jika driver miniport disediakan dengan parameter QoS NDIS lokal milik di registri, driver harus mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE selama atau segera setelah panggilan ke MiniportInitializeEx. Dalam hal ini, driver menginisialisasi struktur NDIS_QOS_PARAMETERS dengan pengaturan parameter QoS NDIS lokal miliknya.

  Untuk informasi selengkapnya tentang cara driver menyelesaikan pengaturan parameter QoS NDIS operasionalnya, lihat Mengatasi Parameter QoS NDIS Operasional.

• Setelah indikasi status awal ini, driver miniport harus mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE ketika parameter QoS NDIS operasionalnya diubah. Misalnya, parameter QoS NDIS operasional dapat berubah dalam kondisi berikut:

  • Parameter QoS NDIS operasional berubah karena perubahan pada parameter QoS NDIS lokal. Parameter ini dapat berubah melalui permintaan metode OID OID_QOS_PARAMETERS atau melalui aplikasi manajemen yang dikembangkan oleh vendor perangkat keras independen (IHV).

  • Parameter QoS NDIS operasional berubah karena konflik dengan pengaturan QoS dari peer jarak jauh.

    Driver miniport menggunakan protokol IEEE 802.1Qaz Data Center Bridging Exchange (DCBX) untuk menemukan parameter QoS untuk peer jarak jauh. Jika status DCBX Willing diaktifkan, driver harus menyelesaikan perbedaan antara parameter QoS-nya dan parameter QoS peer jarak jauh dengan mengikuti prosedur yang ditentukan untuk mesin status DCBX. Untuk informasi selengkapnya tentang mesin status ini, lihat standar draf IEEE 802.1Qaz.

    Untuk informasi selengkapnya tentang status DCBX Willing lokal, lihat Mengelola Status DCBX Lokal yang Bersedia.

  Catatan Ketika driver miniport menerima parameter QoS NDIS lokal atau jarak jauh, driver miniport tidak boleh mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE jika belum ada perubahan pada parameter QoS NDIS operasional. Jika driver membuat indikasi status yang tidak perlu ini, NDIS mungkin tidak meneruskan indikasi ke driver yang terlalu mengandalkan.

• Driver miniport harus mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE ketika perlu mengambil alih parameter QoS NDIS lokal yang digunakan untuk menyelesaikan parameter QoS NDIS operasional.

  Driver miniport memberi tahu NDIS dan driver yang terlalu mengandalkan bahwa ia telah menimpa parameter QoS NDIS lokal dengan mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE . Untuk jenis indikasi ini, driver harus mengatur bendera NDIS_QOS_PARAMETERS_Xxx_CHANGED yang sesuai di anggota Bendera struktur NDIS_QOS_PARAMETERS untuk menentukan alasan untuk mengambil alih parameter QoS NDIS lokal.

  Untuk informasi selengkapnya tentang cara driver miniport mengelola parameter QoS lokal, lihat Mengatur Parameter QoS NDIS Lokal.

  Untuk informasi selengkapnya tentang cara driver miniport menyelesaikan parameter QoS operasionalnya, lihat Mengatasi Parameter QoS NDIS Operasional.

Perhatikan Driver miniport harus mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE jika kemampuan QoS NDIS-nya saat ini diaktifkan melalui kata kunci INF standar kata kunci *QOS. Untuk informasi selengkapnya, lihat Kata Kunci INF Standar untuk QoS NDIS.

Panduan untuk Mengeluarkan Indikasi Status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

Driver miniport mengikuti langkah-langkah ini ketika mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE :

1. Driver miniport mengalokasikan buffer yang cukup besar untuk berisi yang berikut ini:

   • Struktur NDIS_QOS_PARAMETERS yang berisi pengaturan konfigurasi QoS NDIS serta parameter operasional global untuk kelas lalu lintas QoS NDIS.

   • Array struktur NDIS_QOS_CLASSIFICATION_ELEMENT. Masing-masing struktur ini menentukan klasifikasi lalu lintas seperti yang didefinisikan oleh pola data paket (kondisi) dan tingkat prioritas IEEE 802.1p terkait (tindakan). Jika adaptor jaringan menemukan pola dalam transmisi, atau keluar, paket yang cocok dengan kondisi, adaptor jaringan menetapkan tingkat prioritas terkait ke paket. Adaptor juga menerapkan kebijakan QoS NDIS lainnya ke paket berdasarkan tingkat prioritas.

2. Miniport menginisialisasi struktur NDIS_QOS_PARAMETERS dengan parameter QoS NDIS operasional. Driver harus menyediakan set lengkap parameter operasional, termasuk parameter yang mungkin tidak dikonfigurasi pada adaptor jaringan.

   Ketika driver miniport menginisialisasi anggota Header, driver tersebut mengatur jenis anggota Header ke NDIS_OBJECT_TYPE_QOS_PARAMETERS. Driver miniport mengatur anggota Revisi Header ke NDIS_QOS_PARAMETERS_REVISION_1 dan anggota Ukuran ke NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1.

   Driver miniport menetapkan bendera NDIS_QOS_PARAMETERS_Xxx_CHANGED yang sesuai di anggota Bendera jika anggota yang sesuai berisi data yang telah berubah sejak driver miniport mengeluarkan indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE.

   Catatan Mengatur bendera NDIS_QOS_PARAMETERS_Xxx_CHANGED bersifat opsional. NDIS selalu mengasumsikan bahwa anggota NDIS_QOS_PARAMETERS saat ini meskipun mereka belum berubah dari indikasi status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE sebelumnya.

   Untuk informasi selengkapnya tentang cara mengatur anggota Bendera, lihat Panduan untuk Mengatur Anggota Bendera.

3. Driver miniport menginisialisasi struktur NDIS_QOS_CLASSIFICATION_ELEMENT untuk setiap klasifikasi lalu lintas dari parameter QoS NDIS operasional. Driver menambahkan elemen-elemen ini di akhir struktur NDIS_QOS_PARAMETERS di buffer.

   Catatan Driver miniport tidak boleh mengatur bendera NDIS_QOS_CLASSIFICATION_ENFORCED_BY_MINIPORT di anggota Bendera dari struktur NDIS_QOS_CLASSIFICATION_ELEMENT apa pun.

   Driver mengatur anggota NumClassificationElements dari struktur NDIS_QOS_PARAMETERS ke jumlah elemen klasifikasi dalam array. Driver mengatur anggota FirstClassificationElementOffset ke offset byte elemen pertama dari awal buffer. Driver juga mengatur anggota ClassificationElementSize ke panjang, dalam byte, dari setiap elemen dalam array.

   Catatan Dimulai dengan NDIS 6.30, driver miniport harus mengatur anggota ClassificationElementSize ke sizeof(NDIS_QOS_CLASSIFICATION_ELEMENT).

4. Driver miniport menginisialisasi struktur NDIS_STATUS_INDICATION untuk indikasi status dengan cara berikut:

   • Anggota StatusCode harus diatur ke NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE.

   • Anggota StatusBuffer harus diatur ke penunjuk ke buffer yang berisi parameter QoS NDIS operasional.

   • Anggota StatusBufferSize harus diatur ke panjang, dalam byte, dari buffer.

5. Driver miniport mengeluarkan indikasi status dengan memanggil NdisMIndicateStatusEx. Driver harus meneruskan penunjuk ke struktur NDIS_STATUS_INDICATION ke parameter StatusIndication.

Panduan untuk Mengatur Anggota Bendera

Driver miniport mengatur bendera berikut dalam anggota Bendera dari struktur NDIS_QOS_PARAMETERS untuk menentukan parameter QoS NDIS operasional mana yang telah dikonfigurasi atau diubah pada adaptor jaringan:

NDIS_QOS_PARAMETERS_ETS_CONFIGURED
Jika bendera ini diatur, driver miniport telah mengonfigurasi adaptor jaringan dengan parameter ETS yang terkandung dalam anggota berikut:

• NumTrafficClasses

• PriorityAssignmentTable

• TcBandwidthAssignmentTable

• TsaAssignmentTable

Catatan Driver miniport harus mendukung ETS untuk mendukung NDIS QoS untuk DCB. Namun, pengaturan bendera ini tidak menentukan apakah adaptor jaringan mendukung ETS. Sebaliknya, pengaturan bendera ini hanya menentukan apakah parameter ETS dikonfigurasi pada adaptor jaringan.

NDIS_QOS_PARAMETERS_ETS_CHANGED
Jika bendera ini diatur, satu atau beberapa parameter ETS telah berubah dalam anggota berikut:

• NumTrafficClasses

• PriorityAssignmentTable

• TcBandwidthAssignmentTable

• TsaAssignmentTable

NDIS_QOS_PARAMETERS_PFC_CONFIGURED
Jika bendera ini diatur, driver miniport telah mengonfigurasi adaptor jaringan dengan pengaturan PFC yang terkandung dalam anggota PfcEnable .

Catatan Driver miniport harus mendukung PFC untuk mendukung NDIS QoS untuk DCB. Pengaturan bendera ini tidak menentukan apakah adaptor jaringan mendukung PFC. Sebaliknya, pengaturan bendera ini hanya menentukan apakah parameter PFC diaktifkan pada adaptor jaringan.

NDIS_QOS_PARAMETERS_PFC_CHANGED
Jika bendera ini diatur, satu atau beberapa pengaturan PFC telah berubah di anggota PfcEnable .

NDIS_QOS_PARAMETERS_CLASSIFICATION_CONFIGURED
Jika bendera ini diatur, driver miniport telah mengonfigurasi adaptor jaringan dengan parameter klasifikasi lalu lintas QoS yang ditentukan dalam anggota berikut:

• NumClassificationElements

• ClassificationElementSize

• FirstClassificationElementOffset

NDIS_QOS_PARAMETERS_CLASSIFICATION_CHANGED
Jika bendera ini diatur, satu atau beberapa parameter klasifikasi lalu lintas QoS telah berubah di anggota berikut:

• NumClassificationElements

• ClassificationElementSize

• FirstClassificationElementOffset

Perhatikan bendera NDIS_QOS_PARAMETERS_Xxx_CONFIGURED harus diatur jika struktur NDIS_QOS_PARAMETERS berisi pengaturan parameter QoS NDIS. Driver miniport harus mengatur bendera ini terlepas dari apakah pengaturan telah berubah. Namun, driver harus mengatur bendera NDIS_QOS_PARAMETERS_Xxx_CHANGED hanya untuk pengaturan yang telah berubah.