struktur NDIS_QOS_PARAMETERS (ntddndis.h)

Artikel
02/26/2024

Struktur NDIS_QOS_PARAMETERS menentukan parameter NDIS Quality of Service (QoS) yang diaktifkan pada adaptor jaringan yang mendukung antarmuka IEEE 802.1 Data Center Bridging (DCB).

Sintaks

typedef struct _NDIS_QOS_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              NumTrafficClasses;
  UCHAR              PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES];
  UCHAR              TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  UCHAR              TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              PfcEnable;
  ULONG              NumClassificationElements;
  ULONG              ClassificationElementSize;
  ULONG              FirstClassificationElementOffset;
} NDIS_QOS_PARAMETERS, *PNDIS_QOS_PARAMETERS;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_QOS_PARAMETERS . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_QOS_PARAMETERS. Untuk menentukan versi struktur NDIS_QOS_PARAMETERS , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_QOS_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera yang menentukan status parameter QoS NDIS untuk adaptor jaringan. Untuk informasi selengkapnya tentang anggota ini, lihat Gambaran Umum Anggota Bendera.

NumTrafficClasses

Nilai ULONG yang menentukan jumlah kelas lalu lintas QoS NDIS yang diaktifkan pada adaptor jaringan. Setiap kelas lalu lintas direferensikan melalui pengidentifikasi dalam rentang dari nol hingga (NumTrafficClasses–1).

Catatan Nilai anggota NumTrafficClasses harus kurang dari atau sama dengan min(NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES, MaxNumTrafficClasses), di mana MaxNumTrafficClasses adalah nilai anggota MaxNumTrafficClasses yang ditentukan dalam struktur NDIS_QOS_CAPABILITIES .

PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES]

Array elemen UCHAR di mana setiap elemen mewakili kelas lalu lintas yang terkait dengan tingkat prioritas IEEE 802.1p. Array PriorityAssignmentTable diindeks oleh tingkat prioritas 802,1p (0–7).

Setiap elemen berisi pengidentifikasi kelas lalu lintas. Pengidentifikasi ini adalah indeks struktur NDIS_QOS_CLASSIFICATION_ELEMENT untuk kelas lalu lintas dalam array klasifikasi.

Catatan Setiap elemen dalam array PriorityAssignmentTable harus diberi pengidentifikasi kelas lalu lintas yang valid. Pengidentifikasi kelas lalu lintas dapat ditetapkan ke lebih dari satu elemen dalam array PriorityAssignmentTable .

TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Array elemen UCHAR yang menentukan persentase alokasi bandwidth yang ditetapkan untuk setiap kelas lalu lintas. Array TcBandwidthAssignmentTable diindeks oleh pengidentifikasi kelas lalu lintas.

Setiap elemen array TcBandwidthAssignmentTable menentukan alokasi bandwidth untuk kelas lalu lintas. Nilai total semua penetapan alokasi bandwidth dalam array TcBandwidthAssignmentTable harus sama dengan 100.

Catatan Alokasi bandwidth hanya didukung untuk TSA Enhanced Transmission Selection (ETS). Jika elemen untuk kelas lalu lintas dalam array TsaAssignmentTable tidak diatur ke NDIS_QOS_TSA_ETS, elemen untuk kelas lalu lintas dalam array TcBandwidthAssignmentTable harus diatur ke nol.

TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Array elemen UCHAR yang menentukan TSA yang ditetapkan untuk setiap kelas lalu lintas. Array TsaAssignmentTable diindeks oleh pengidentifikasi kelas lalu lintas.

Setiap elemen array TsaAssignmentTable berisi salah satu nilai berikut ini:

NDIS_QOS_TSA_STRICT

Algoritma prioritas ketat harus digunakan sebagai TSA untuk kelas lalu lintas. Untuk informasi selengkapnya tentang TSA ini, lihat Algoritma Prioritas Ketat.

NDIS_QOS_TSA_CBS

Algoritma pembentuk berbasis kredit (CBS) IEEE 802.1Qav harus digunakan sebagai TSA untuk kelas lalu lintas.

Catatan Dimulai dengan Windows Server 2012, komponen DCB (Msdcb.sys) tidak mendukung TSA CBS dan tidak akan mengaktifkan parameter ini melalui permintaan metode pengidentifikasi objek (OID) OID_QOS_PARAMETERS. Untuk informasi selengkapnya tentang komponen DCB, lihat Arsitektur QoS NDIS untuk Bridging Pusat Data.

NDIS_QOS_TSA_ETS

Algoritma IEEE 802.1Qaz Enhanced Transmission Selection (ETS) harus digunakan sebagai TSA untuk kelas lalu lintas. Untuk informasi selengkapnya tentang TSA ini, lihat Algoritma Enhanced Transmission Selection (ETS).

PfcEnable

Bitmap 32 bit. 24 bit yang paling signifikan disediakan untuk digunakan di masa mendatang. 8 bit yang paling tidak signifikan digunakan untuk menentukan apakah PFC diaktifkan pada tingkat prioritas IEEE 802.1p. Jika bit diatur ke satu, PFC diaktifkan untuk tingkat prioritas.

Rentang bit	Makna
31:24	Disiapkan untuk penggunaan masa mendatang.
7	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 7 (kontrol jaringan).
6	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 6 (kontrol internetwork).
5	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 5 (suara).
4	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 4 (video).
3	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 3 (aplikasi penting).
2	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 2 (upaya yang sangat baik).
1	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 1 (latar belakang).
0	Jika diatur ke satu, PFC diaktifkan pada tingkat prioritas 802.1p 0 (upaya terbaik).

Catatan Jumlah total tingkat prioritas 802.1p yang mengaktifkan PFC harus kurang dari atau sama dengan nilai anggota MaxNumPfcEnabledTrafficClasses dalam struktur NDIS_QOS_CAPABILITIES .

Untuk informasi selengkapnya tentang tingkat prioritas, lihat Tingkat Prioritas IEEE 802.1p.

NumClassificationElements

Nilai ULONG yang menentukan jumlah elemen dalam array klasifikasi lalu lintas. Offset ke elemen pertama dalam array ini ditentukan oleh anggota FirstClassificationElementOffset .

Catatan Setiap elemen dalam array diformat sebagai struktur NDIS_QOS_CLASSIFICATION_ELEMENT .

ClassificationElementSize

Nilai ULONG yang menentukan ukuran, dalam byte, dari setiap elemen dalam array klasifikasi lalu lintas.

Catatan Dimulai dengan NDIS 6.30, anggota ini harus diatur ke sizeof(NDIS_QOS_CLASSIFICATION_ELEMENT).

FirstClassificationElementOffset

Nilai ULONG yang menentukan offset, dalam byte, ke elemen pertama dalam array elemen klasifikasi lalu lintas yang mengikuti struktur ini. Offset diukur dari awal struktur NDIS_QOS_PARAMETERS hingga awal elemen pertama. Setiap elemen dalam array adalah struktur NDIS_QOS_CLASSIFICATION_ELEMENT .

Catatan Jika NumClassificationElements diatur ke nol, anggota ini diabaikan.

Keterangan

Struktur NDIS_QOS_PARAMETERS menentukan parameter yang menentukan bagaimana adaptor jaringan memprioritaskan pengiriman, atau keluar, paket. Struktur ini digunakan dalam permintaan OID berikut:

Permintaan kueri OID dari OID_QOS_OPERATIONAL_PARAMETERS. Permintaan OID ini mengembalikan parameter QoS operasional yang saat ini disediakan pada adaptor jaringan.
Permintaan kueri OID dari OID_QOS_REMOTE_PARAMETERS. Permintaan OID ini mengembalikan parameter QoS jarak jauh yang saat ini disediakan pada adaptor jaringan.
Permintaan metode OID dari OID_QOS_PARAMETERS. Permintaan OID ini menyediakan adaptor jaringan dengan parameter QoS lokal.

Driver miniport juga mengembalikan struktur NDIS_QOS_PARAMETERS dalam indikasi status NDIS berikut:

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE. Driver miniport ini mengeluarkan indikasi status ini ketika parameter QoS operasionalnya berubah.
NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE. Driver miniport ini mengeluarkan indikasi status ini ketika parameter QoS jarak jauhnya berubah.

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

Gambaran Umum Anggota Bendera

Anggota Bendera berisi bitwise ATAU bendera yang menentukan status parameter QoS NDIS untuk adaptor jaringan.

Driver miniport menetapkan anggota Bendera saat mengeluarkan indikasi status NDIS berikut:

Komponen DCB mengatur anggota Bendera saat mengeluarkan permintaan metode OID OID_QOS_PARAMETERS.

Catatan Hanya komponen DCB yang dapat mengeluarkan permintaan OID. 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.

Bendera berikut ditentukan untuk anggota Bendera .

Catatan NDIS menjamin bahwa bendera NDIS_QOS_PARAMETERS_ETS_CONFIGURED dan NDIS_QOS_PARAMETERS_PFC_CONFIGURED diatur atau dibersihkan bersamaan.

Bendera NDIS_QOS_PARAMETERS_Xxx_CHANGED memberikan petunjuk apakah grup parameter yang sesuai telah berubah dari permintaan metode OID_QOS_PARAMETERS sebelumnya atau NDIS_QOS_PARAMETERS_Xxx_CHANGED pemberitahuan status. Ketika driver miniport mengeluarkan pemberitahuan status NDIS_QOS_PARAMETERS_Xxx_CHANGED , driver tersebut dapat secara opsional mengatur bendera ini.

Catatan Jika bendera NDIS_QOS_PARAMETERS_Xxx_CHANGED tidak diatur, driver yang berlebihan tidak boleh berasumsi bahwa grup parameter yang sesuai didukung atau diaktifkan pada adaptor jaringan yang mendasar.