struktur NDIS_QOS_SQ_PARAMETERS (ntddndis.h)

Artikel
03/10/2023

Struktur NDIS_QOS_SQ_PARAMETERS berisi parameter Antrean Penjadwal Kualitas Layanan (QoS) NDIS (SQ).

Sintaks

typedef struct _NDIS_QOS_SQ_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_QOS_SQ_ID     SqId;
  NDIS_QOS_SQ_TYPE   SqType;
  BOOLEAN            TcEnabledTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              TcTransmitBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              TcTransmitBandwidthReservationTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              TcReceiveBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              CrossTcTransmitBandwidthCap;
  ULONG              MaxNumSqInputs;
} NDIS_QOS_SQ_PARAMETERS, *PNDIS_QOS_SQ_PARAMETERS;

Anggota

Header

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

Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT, anggota Revisi ke NDIS_QOS_SQ_PARAMETERS_REVISION_2, dan anggota Ukuran ke NDIS_SIZEOF_QOS_SQ_PARAMETERS_REVISION_2.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera. Bendera ini menentukan kemampuan dan atribut lain-lain dari fitur Offload QoS Perangkat Keras yang diaktifkan pada SQ. Bendera berikut didefinisikan:

NDIS_QOS_SQ_TRANSMIT_CAP_ENABLED

Jika bendera ini diatur, batas bandwidth pengiriman diaktifkan pada SQ ini.

NDIS_QOS_SQ_TRANSMIT_RESERVATION_ENABLED

Jika bendera ini diatur, kirimkan reservasi bandwidth diaktifkan pada SQ ini.

NDIS_QOS_SQ_RECEIVE_CAP_ENABLED

Jika bendera ini diatur, batas bandwidth penerima diaktifkan pada SQ ini.

SqId

NDIS_QOS_SQ_ID yang berisi ID SQ SQ ini. NDIS menetapkan ID ini.

SqType

NDIS_QOS_SQ_TYPE yang berisi jenis SQ ini. Ini bisa menjadi NdisQSQosSqSQTypeStandard dari definisi enum NDIS_QOS_SQ_TYPE.

TcEnabledTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Array nilai BOOLEAN yang menentukan apakah setiap kelas lalu lintas (dari 0 hingga NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES) diaktifkan untuk penjadwalan pada SQ ini.

Setiap kelas lalu lintas (TC) yang bidang ini TRUE harus dibaca dan divalidasi dalam tabel di bawah ini, dan juga dibatasi oleh CrossTcTransmitBandwidthCap.

Setiap TC yang bidang ini false tidak berpartisipasi dalam pembatasan tarif QoS dari CrossTcTransmitBandwidthCap atau tabel per TC di bawah ini.

TcTransmitBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Array elemen ULONG yang menentukan batas bandwidth pengiriman untuk setiap TC, dalam Mbps. Elemen hanya valid jika NDIS_QOS_SQ_TRANSMIT_CAP_ENABLED bendera diatur dan elemen yang sesuai di TcEnabledTable adalah TRUE. Elemen dengan nilai 0 tidak memiliki batas.

NIC harus mengantre paket pengiriman apa pun pada SQ ini untuk TC tertentu jika melebihi tarif yang ditentukan dalam tabel ini.

TcTransmitBandwidthReservationTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Array elemen ULONG yang menentukan pengiriman reservasi bandwidth untuk setiap TC, dalam nilai relatif dari 0 – ULONG_MAX. Elemen hanya valid jika NDIS_QOS_SQ_TRANSMIT_RESERVATION_ENABLED bendera diatur dan elemen yang sesuai di TcEnabledTable adalah TRUE. Elemen dengan nilai 0 berarti mengirimkan paket pada SQ/TC ini berbagi reservasi SQ default untuk TC tersebut.

NIC harus mengantre paket pengiriman apa pun pada SQ ini untuk TC tertentu jika SQ lain memerlukan bandwidth untuk memenuhi reservasi mereka untuk TC ini.

TcReceiveBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Array elemen ULONG yang menentukan batas bandwidth terima untuk setiap TC, dalam Mbps. Elemen hanya valid jika NDIS_QOS_SQ_RECEIVE_CAP_ENABLED bendera diatur dan elemen yang sesuai di TcEnabledTable adalah TRUE. Elemen dengan nilai 0 tidak memiliki batas.

Ini adalah fitur opsional untuk mengaktifkan pembatasan bandwidth penerima. NIC yang mengiklankan dukungan batas penerimaan harus menghilangkan paket terima apa pun setelah TC tertentu pada SQ ini telah melebihi tarif yang ditentukan dalam array ini (berdasarkan implementasi penjadwalan NIC).

CrossTcTransmitBandwidthCap

Nilai ULONG yang menentukan batas bandwidth pengiriman untuk lalu lintas di seluruh TC yang elemen terkaitnya di TcEnabledTable adalah TRUE, jika NDIS_QOS_SQ_TRANSMIT_CAP_ENABLED bendera diatur.

MaxNumSqInputs

Nilai ULONG yang menawarkan "petunjuk" ke miniport pada kemungkinan jumlah vPort yang akan dikaitkan dengan OS dengan SQ. Nilai ini tidak dapat diubah setelah pembuatan SQ.

Miniport dapat menggunakan petunjuk ini untuk mengelola sumber dayanya dengan lebih baik. Miniport akan memberikan layanan upaya terbaik untuk memenuhi permintaan, tetapi mungkin gagal karena sumber daya yang tidak mencukupi pada waktu pembuatan SQ atau waktu asosiasi vPort.

Miniport harus mengembalikan kesalahan jika nilai ini melebihi nilai MaxNumSQInputs yang ditentukan oleh miniport di NDIS_QOS_OFFLOAD_CAPABILITIES.

Keterangan

Struktur NDIS_QOS_SQ_PARAMETERS dikembalikan dalam permintaan kueri OID OID_QOS_OFFLOAD_ENUM_SQS, yang menghitung SQ yang dibuat pada sakelar NIC.

NDIS_QOS_SQ_PARAMETERS juga dikembalikan dalam OID_QOS_OFFLOAD_CREATE_SQ permintaan metode OID, yang membuat SQ baru pada adaptor miniport.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.85 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2022
Header	ntddndis.h (termasuk ndis.h)