Auf Englisch lesen

Freigeben über


NDIS_QOS_PARAMETERS Struktur (ntddndis.h)

Die NDIS_QOS_PARAMETERS-Struktur gibt die NDIS Quality of Service (QoS)-Parameter an, die auf einem Netzwerkadapter aktiviert sind, der die IEEE 802.1 Data Center Bridging (DCB)-Schnittstelle unterstützt.

Syntax

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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_QOS_PARAMETERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_QOS_PARAMETERS festlegen. Um die Version der NDIS_QOS_PARAMETERS-Struktur anzugeben, muss der Treiber das element RevisionHeader- auf den folgenden Wert festlegen:

NDIS_QOS_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1 fest.

Flags

Ein ULONG--Wert, der einen bitweisen ODER von Flags enthält, die den Status der NDIS-QoS-Parameter für den Netzwerkadapter angeben. Weitere Informationen zu diesem Mitglied finden Sie unter Übersicht über das Flags-Element.

NumTrafficClasses

Ein ULONG--Wert, der die Anzahl der NDIS-QoS-Datenverkehrsklassen angibt, die auf dem Netzwerkadapter aktiviert sind. Auf jede Datenverkehrsklasse wird über einen Bezeichner im Bereich von Null bis (NumTrafficClasses-1) verwiesen.

Hinweis Der Wert des NumTrafficClasses Members muss kleiner oder gleich min(NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES, MaxNumTrafum sein), wobei MaxNumTrafficClasses der Wert der MaxNumTrafficClasses Member ist, das in der NDIS_QOS_CAPABILITIES Struktur angegeben wurde.
 

PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES]

Ein Array von UCHAR- Elementen, bei denen jedes Element die Datenverkehrsklasse darstellt, die einer IEEE 802.1p-Prioritätsebene zugeordnet ist. Das PriorityAssignmentTable- Arrays wird von der Prioritätsebene 802.1p (0 bis 7) indiziert.

Jedes Element enthält den Datenverkehrsklassenbezeichner. Dieser Bezeichner ist der Index der NDIS_QOS_CLASSIFICATION_ELEMENT Struktur für die Datenverkehrsklasse innerhalb des Klassifizierungsarrays.

Hinweis Jedem Element in der PriorityAssignmentTable Array muss ein gültiger Datenverkehrsklassenbezeichner zugewiesen werden. Ein Datenverkehrsklassenbezeichner kann mehreren Elementen im PriorityAssignmentTable Arrays zugewiesen werden.
 

TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Ein Array von UCHAR--Elementen, die den Prozentsatz der Bandbreitenzuweisung angibt, die jeder Datenverkehrsklasse zugewiesen ist. Das TcBandwidthAssignmentTable Arrays wird vom Datenverkehrsklassenbezeichner indiziert.

Jedes Element der TcBandwidthAssignmentTable Array gibt die Bandbreitenzuordnung für die Datenverkehrsklassen an. Der Gesamtwert aller Bandbreitenzuweisungen in der TcBandwidthAssignmentTable Array muss 100 entsprechen.

Hinweis Bandbreitenzuteilung nur für die TSA (Enhanced Transmission Selection, ETS) unterstützt wird. Wenn das Element für die Datenverkehrsklasse in der TsaAssignmentTable Array nicht auf NDIS_QOS_TSA_ETS festgelegt ist, muss das Element für die Datenverkehrsklasse in der TcBandwidthAssignmentTable Array auf Null festgelegt werden.
 

TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Ein Array von UCHAR- Elementen, die die TSA angibt, die jeder Datenverkehrsklasse zugewiesen ist. Das TsaAssignmentTable Arrays wird vom Datenverkehrsklassenbezeichner indiziert.

Jedes Element der TsaAssignmentTable Array enthält einen der folgenden Werte:

NDIS_QOS_TSA_STRICT

Der Strenge Prioritätsalgorithmus muss als TSA für die Datenverkehrsklasse verwendet werden. Weitere Informationen zu dieser TSA finden Sie unter Strict Priority Algorithm.

NDIS_QOS_TSA_CBS

Der IEEE 802.1Qav credit-based shaper (CBS)-Algorithmus muss als TSA für die Datenverkehrsklasse verwendet werden.

Hinweis Ab Windows Server 2012 unterstützt die DCB-Komponente (Msdcb.sys) die CBS TSA nicht und aktiviert diesen Parameter nicht über OID-Methodenanforderungen (Object Identifier) von OID_QOS_PARAMETERS. Weitere Informationen zur DCB-Komponente finden Sie unter NDIS QoS Architecture for Data Center Bridging.
 

NDIS_QOS_TSA_ETS

Der IEEE 802.1Qaz Enhanced Transmission Selection (ETS)-Algorithmus muss als TSA für die Datenverkehrsklasse verwendet werden. Weitere Informationen zu diesem TSA finden Sie unter Enhanced Transmission Selection (ETS)-Algorithmus.

PfcEnable

Eine Bitmap mit 32 Bit. Die wichtigsten 24 Bits sind für die zukünftige Verwendung reserviert. Die am wenigsten signifikanten 8 Bit werden verwendet, um anzugeben, ob PFC auf der IEEE 802.1p-Prioritätsebene aktiviert ist. Wenn das Bit auf eins festgelegt ist, ist PFC für die Prioritätsebene aktiviert.

Bitbereich Bedeutung
31:24 Reserviert für die zukünftige Verwendung.
7 Wenn dieser Wert auf "1" festgelegt ist, ist PFC auf 802.1p-Prioritätsebene 7 (Netzwerksteuerung) aktiviert.
6 Wenn dieser Wert auf "1" festgelegt ist, ist PFC auf 802.1p-Prioritätsebene 6 aktiviert (Internetwork-Steuerelement).
5 Wenn dieser Wert auf "1" festgelegt ist, ist PFC auf 802,1p Prioritätsebene 5 (VoIP-) aktiviert.
4 Wenn dieser Wert auf "1" festgelegt ist, ist PFC auf 802,1p Prioritätsebene 4 (Video-) aktiviert.
3 Wenn dieser Wert auf 1 festgelegt ist, ist PFC auf 802,1p Prioritätsebene 3 (kritische Anwendungen) aktiviert.
2 Wenn dieser Wert auf "1" festgelegt ist, ist PFC auf 802,1p Prioritätsebene 2 aktiviert (hervorragende Leistung).
1 Wenn dieser Wert auf "1" festgelegt ist, ist PFC auf 802.1p-Prioritätsebene 1 (Hintergrund) aktiviert.
0 Wenn dieser Wert auf "1" festgelegt ist, ist PFC auf 802,1p-Prioritätsebene 0 (beste Leistung) aktiviert.
 
Hinweis Die Gesamtanzahl der 802,1p-Prioritätsebenen, für die PFC aktiviert ist, muss kleiner oder gleich dem Wert der MaxNumPfcEnabledTrafficClasses Member in der NDIS_QOS_CAPABILITIES-Struktur sein.
 
Weitere Informationen zu Prioritätsstufen finden Sie unter IEEE 802.1p Priority Levels.

NumClassificationElements

Ein ULONG--Wert, der die Anzahl der Elemente im Datenverkehrsklassifizierungsarray angibt. Der Offset auf das erste Element in diesem Array wird durch das FirstClassificationElementOffset Member angegeben.

Note Each element in the array is formatted as an NDIS_QOS_CLASSIFICATION_ELEMENT structure.
 

ClassificationElementSize

Ein ULONG- Wert, der die Größe jedes Elements im Datenverkehrsklassifizierungsarray in Byte angibt.

Hinweis Ab NDIS 6.30 muss dieses Element auf sizeof(NDIS_QOS_CLASSIFICATION_ELEMENTfestgelegt sein).
 

FirstClassificationElementOffset

Ein ULONG- Wert, der den Offset in Byte angibt, auf das erste Element in einem Array von Datenverkehrsklassifizierungselementen, die dieser Struktur folgen. Der Offset wird vom Anfang der NDIS_QOS_PARAMETERS Struktur bis zum Anfang des ersten Elements gemessen. Jedes Element im Array ist eine NDIS_QOS_CLASSIFICATION_ELEMENT Struktur.

Hinweis Wenn NumClassificationElements- auf Null festgelegt ist, wird dieses Element ignoriert.
 

Bemerkungen

Die NDIS_QOS_PARAMETERS-Struktur gibt die Parameter an, die definieren, wie der Netzwerkadapter die Übertragung priorisiert, oder AusgangPaketen. Diese Struktur wird in den folgenden OID-Anforderungen verwendet:

  • OID-Abfrageanforderung von OID_QOS_OPERATIONAL_PARAMETERS. Diese OID-Anforderung gibt die betriebsbereiten QoS-Parameter zurück, die derzeit auf dem Netzwerkadapter bereitgestellt werden.
  • OID-Abfrageanforderung von OID_QOS_REMOTE_PARAMETERS. Diese OID-Anforderung gibt die Remote-QoS-Parameter zurück, die derzeit auf dem Netzwerkadapter bereitgestellt werden.
  • OID-Methodenanforderungen von OID_QOS_PARAMETERS. Diese OID-Anforderung stellt den Netzwerkadapter mit den lokalen QoS-Parametern bereit.
Der Miniporttreiber gibt auch eine NDIS_QOS_PARAMETERS Struktur in den folgenden NDIS-Statusanzeigen zurück: Weitere Informationen zu den Typen von NDIS-QoS-Parametern finden Sie unter Übersicht über NDIS-QoS-Parameter.

Übersicht über das Flags-Mitglied

Das Flags Member enthält ein bitweises ODER von Flags, die den Status der NDIS QoS-Parameter für den Netzwerkadapter angeben.

Der Miniporttreiber legt den Flags Member fest, wenn er die folgenden NDIS-Statusanzeigen ausgibt:

Die DCB-Komponente legt die Flags Member fest, wenn sie eine OID-Methodenanforderung von OID_QOS_PARAMETERSausgibt.
Hinweis Nur die DCB-Komponente kann die OID-Anforderung ausgeben. Ein übermäßiger Protokoll- oder Filtertreiber darf dieses OID nicht ausstellen. Weitere Informationen zur DCB-Komponente finden Sie unter NDIS QoS Architecture for Data Center Bridging.
 
Die folgenden Flags werden für das Flags Member definiert.
Hinweis NDIS garantiert, dass sowohl die NDIS_QOS_PARAMETERS_ETS_CONFIGURED als auch NDIS_QOS_PARAMETERS_PFC_CONFIGURED Flags zusammen festgelegt oder gelöscht werden.
 
Die NDIS_QOS_PARAMETERS_Xxx-_CHANGED Flags enthalten Hinweise darauf, ob sich die entsprechende Gruppe von Parametern von einer vorherigen OID_QOS_PARAMETERS Methodenanforderung geändert hat, oder NDIS_QOS_PARAMETERS_Xxx_CHANGED Statusbenachrichtigung. Wenn der Miniporttreiber die NDIS_QOS_PARAMETERS_Xxx-_CHANGED Statusbenachrichtigungen ausgibt, kann er optional diese Flags festlegen.
Hinweis Wenn die NDIS_QOS_PARAMETERS_Xxx-_CHANGED Flags nicht festgelegt sind, dürfen übermäßig viele Treiber nicht davon ausgehen, dass die entsprechende Gruppe von Parametern auf dem zugrunde liegenden Netzwerkadapter unterstützt oder aktiviert wird.
 

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.30 und höher.
Header- ntddndis.h (include Ndis.h)

Siehe auch

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OBJECT_HEADER

NDIS_QOS_CAPABILITIES

NDIS_QOS_CLASSIFICATION_ELEMENT

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE

NdisMSetMiniportAttributes

OID_QOS_CURRENT_CAPABILITIES

OID_QOS_HARDWARE_CAPABILITIES