struktur NDIS_QOS_CLASSIFICATION_ELEMENT (ntddndis.h)

Artikel
03/08/2023

Struktur NDIS_QOS_CLASSIFICATION_ELEMENT menentukan klasifikasi lalu lintas Kualitas Layanan (QoS) NDIS untuk adaptor jaringan yang mendukung antarmuka IEEE 802.1 Data Center Bridging (DCB).

Setiap klasifikasi lalu lintas menentukan hal berikut:

Kondisi klasifikasi yang didasarkan pada pola data dalam data paket keluar.
Dimulai dengan NDIS 6.30, kondisi klasifikasi didasarkan pada nilai 16-bit, seperti port tujuan UDP atau TCP atau kontrol akses media (MAC) EtherType.
Tindakan klasifikasi yang menentukan kelas lalu lintas yang akan digunakan untuk menangani paket keluar.
Dimulai dengan NDIS 6.30, tindakan klasifikasi menentukan tingkat prioritas 802,1p.

Misalnya, klasifikasi lalu lintas dapat menentukan bahwa semua paket keluar untuk port TCP tujuan nomor 3260 (kondisi) diberi prioritas 802,1p tingkat 3 (tindakan).

Sintaks

typedef struct _NDIS_QOS_CLASSIFICATION_ELEMENT {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             ConditionSelector;
  USHORT             ConditionField;
  USHORT             ActionSelector;
  USHORT             ActionField;
} NDIS_QOS_CLASSIFICATION_ELEMENT, *PNDIS_QOS_CLASSIFICATION_ELEMENT;

Anggota

Header

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

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

NDIS_QOS_CLASSIFICATION_ELEMENT_REVISION_1

Versi asli untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_QOS_CLASSIFICATION_ELEMENT_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera yang menentukan status klasifikasi lalu lintas QoS NDIS yang didukung driver miniport. Bendera berikut didefinisikan:

NDIS_QOS_CLASSIFICATION_ENFORCED_BY_MINIPORT

Jika bendera ini diatur, driver miniport menerima parameter klasifikasi lalu lintas yang ditentukan dalam struktur NDIS_QOS_CLASSIFICATION_ELEMENT . Jika driver menerima parameter, driver harus mengonfigurasi adaptor jaringan untuk melakukan klasifikasi lalu lintas seperti yang ditentukan oleh parameter.

Catatan Bendera ini hanya diatur dalam struktur NDIS_QOS_CLASSIFICATION_ELEMENT yang dikembalikan driver miniport ke NDIS dari permintaan metode OID OID_QOS_PARAMETERS .

ConditionSelector

Nilai USHORT yang menentukan jenis pola data yang terkandung dalam anggota ConditionField . Misalnya, jenis pola data dapat menentukan port UDP tujuan yang nilainya ditentukan oleh anggota ConditionField .

Untuk informasi selengkapnya, lihat Panduan untuk Mengatur Anggota ConditionSelector dan ConditionField.

ConditionField

Nilai USHORT yang berisi pola data yang jenisnya ditentukan oleh anggota ConditionSelector .

Untuk informasi selengkapnya, lihat Panduan untuk Mengatur Anggota ConditionSelector dan ConditionField.

ActionSelector

Nilai USHORT yang menentukan jenis data tindakan yang terkandung dalam anggota ActionField . Dimulai dengan NDIS 6.30, jenis data tindakan menentukan tingkat prioritas 802.1p yang nilainya ditentukan oleh anggota ConditionField .

Untuk informasi selengkapnya, lihat Panduan untuk Mengatur ActionSelector dan ActionField Members.

ActionField

Nilai USHORT yang berisi nilai tindakan yang jenisnya ditentukan oleh anggota ActionSelector .

Untuk informasi selengkapnya, lihat Panduan untuk Mengatur ActionSelector dan ActionField Members.

Keterangan

Klasifikasi lalu lintas menentukan kondisi dan tindakan yang diterapkan adaptor jaringan untuk data paket keluar. Ketika adaptor memeriksa data paket keluar dan menemukan kondisi klasifikasi yang cocok, adaptor menerapkan tindakan yang sesuai ke paket keluar.

Catatan Dimulai dengan NDIS 6.30, semua tindakan didasarkan pada tingkat prioritas 802,1p. Namun, setelah adaptor jaringan menentukan tingkat prioritas, adaptor harus menggunakan kebijakan keluar untuk kelas lalu lintas QoS NDIS yang terkait dengan tingkat prioritas. Asosiasi tingkat prioritas ke kelas lalu lintas ditentukan dalam struktur NDIS_QOS_PARAMETERS .

Struktur NDIS_QOS_CLASSIFICATION_ELEMENT menentukan setiap elemen klasifikasi lalu lintas dalam array yang ditentukan oleh struktur NDIS_QOS_PARAMETERS . Struktur ini digunakan dalam permintaan OID berikut:

Permintaan kueri OID dari OID_QOS_OPERATIONAL_PARAMETERS dan OID_QOS_REMOTE_PARAMETERS.
Permintaan metode OID dari OID_QOS_PARAMETERS.

Driver miniport juga mengembalikan struktur NDIS_QOS_PARAMETERS yang berisi array struktur NDIS_QOS_CLASSIFICATION_ELEMENT dalam indikasi status NDIS berikut:

Untuk informasi selengkapnya, lihat Klasifikasi Lalu Lintas QoS NDIS.

Panduan untuk Mengatur Anggota ConditionSelector dan ConditionField

Tabel berikut menentukan rentang nilai untuk anggota ConditionSelector dan ConditionField .

Nilai ConditionSelector	Nilai ConditionField
NDIS_QOS_CONDITION_RESERVED	Anggota ConditionField harus diatur ke nol. Catatan Kondisi ini disediakan untuk digunakan di masa mendatang.
NDIS_QOS_CONDITION_DEFAULT	Anggota ConditionField harus diatur ke nol.
NDIS_QOS_CONDITION_TCP_PORT	Anggota ConditionField berisi nilai port TCP tujuan 16-bit.
NDIS_QOS_CONDITION_UDP_PORT	Anggota ConditionField berisi nilai port UDP tujuan 16-bit.
NDIS_QOS_CONDITION_TCP_OR_UDP_PORT	Anggota ConditionField berisi nilai port TCP atau UDP tujuan 16-bit.
NDIS_QOS_CONDITION_ETHERTYPE	Anggota ConditionField berisi nilai IEEE EtherType 16-bit. Catatan Adaptor jaringan perlu menentukan tata letak bingkai paket untuk memeriksa EtherType. Misalnya, lokasi bidang EtherType berbeda antara bingkai Ethernet II dan 802.3.
NDIS_QOS_CONDITION_NETDIRECT_PORT	Anggota ConditionField berisi nilai port NetworkDirect 16-bit.

Jika anggota ConditionSelector berisi nilai NDIS_QOS_CONDITION_DEFAULT, tindakan klasifikasi terkait harus diterapkan ke semua paket keluar yang tidak cocok dengan kondisi klasifikasi lainnya. Ketika komponen DCB mengeluarkan permintaan metode OID OID_QOS_PARAMETERS, komponen tersebut dapat mengatur ConditionSelector ke NDIS_QOS_CONDITION_DEFAULT hanya dalam struktur NDIS_QOS_CLASSIFICATION_ELEMENT pertama dalam array NDIS_QOS_PARAMETERS .

Jika anggota ConditionSelector berisi nilai NDIS_QOS_CONDITION_NETDIRECT_PORT, driver miniport harus cocok dengan anggota ConditionField terhadap port sumber atau tujuan koneksi NetworkDirect. Jika driver miniport menerima koneksi NetDirect, driver harus mencocokkan anggota ConditionField dengan port sumber paket apa pun yang dikirimnya melalui koneksi tersebut. Jika driver miniport memulai koneksi NetDirect, driver tersebut harus cocok dengan anggota ConditionField dengan port tujuan paket apa pun yang dikirimnya melalui koneksi tersebut.

Untuk informasi selengkapnya tentang komponen DCB, lihat Arsitektur QoS NDIS untuk Bridging Pusat Data.

Panduan untuk Mengatur ActionSelector dan ActionField Members

Tabel berikut menentukan rentang nilai untuk anggota ActionSelector dan ActionField .

Nilai ActionSelector	Nilai ActionField
NDIS_QOS_ACTION_PRIORITY	Anggota ActionField berisi nilai tingkat prioritas IEEE 802.1p 3-bit. Untuk informasi selengkapnya tentang tingkat prioritas ini, lihat Tingkat Prioritas IEEE 802.1p.

Dimulai dengan NDIS 6.30, tindakan klasifikasi lalu lintas menentukan tingkat prioritas IEEE 802.1p tempat paket keluar ditetapkan. Ketika adaptor jaringan menetapkan tingkat prioritas ke paket keluar, adaptor juga menerapkan parameter untuk kelas lalu lintas QoS NDIS yang terkait dengan tingkat prioritas yang ditentukan. Parameter ini menentukan bagaimana adaptor jaringan mengirimkan paket, dan mencakup alokasi bandwidth dan algoritma pemilihan transmisi (TSA).

Untuk informasi selengkapnya tentang kelas lalu lintas QoS NDIS, lihat Kelas Lalu Lintas QoS NDIS.