NDIS_QOS_CAPABILITIES Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_QOS_CAPABILITIES Struktur gibt die NDIS Quality of Service (QoS)-Funktionen eines Netzwerkadapters an, der die IEEE 802.1 Data Center Bridging (DCB)-Schnittstelle unterstützt.

Syntax

typedef struct _NDIS_QOS_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              MaxNumTrafficClasses;
  ULONG              MaxNumEtsCapableTrafficClasses;
  ULONG              MaxNumPfcEnabledTrafficClasses;
} NDIS_QOS_CAPABILITIES, *PNDIS_QOS_CAPABILITIES;

Angehörige

Header

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

Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_QOS_CAPABILITIES festlegen. Um die Version der NDIS_QOS_CAPABILITIES-Struktur anzugeben, muss der Treiber den Revision Member Header- auf den folgenden Wert festlegen:

NDIS_QOS_CAPABILITIES_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie den Size Member auf NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1 fest.

Flags

Ein ULONG--Wert, der einen bitweisen ODER- von Flags enthält, die die von einem Netzwerkadapter unterstützten NDIS-QoS-Funktionen angeben. Die folgenden Flags sind definiert:

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

Wenn dieses Kennzeichen festgelegt ist, unterstützt der Netzwerkadapter den Algorithmus für die Auswahl strenger Priorität (Transmission Selection Algorithm, TSA). Weitere Informationen zu diesem Algorithmus finden Sie unter Strict Priority Algorithm.

Hinweis Um mit DCB kompatibel zu sein, muss der Netzwerkadapter die strikte Priorität TSA unterstützen.

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

Wenn dieses Flag festgelegt ist, unterstützt der Netzwerkadapter die Möglichkeit, die Verarbeitung der Medienzugriffskontrolle (Media Access Control Security, MACsec) zu umgehen. Weitere Informationen zu MACsec finden Sie im Standard 802.1AE-2006.

NDIS_QOS_CAPABILITIES_CEE_DCBX_SUPPORTED

Wenn dieses Kennzeichen festgelegt ist, unterstützt der Netzwerkadapter und der Miniporttreiber die Protokolle, die das IEEE 802.1Qaz Data Center Bridging Exchange (DCBX)-Protokoll vor dem Datum aufweisen. Diese Protokolle umfassen die Converged Enhanced Ethernet (CEE)-Suite von Protokollen.

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

Wenn dieses Kennzeichen festgelegt ist, unterstützt der Netzwerkadapter und der Miniporttreiber das IEEE 802.1Qaz DCBX-Protokoll. Mit dem DCBX-Protokoll können DCB-Parameter zwischen zwei direkt verbundenen Peers ausgetauscht werden. Auf diese Weise können diese Peers diese Parameter anpassen und optimieren, um die Datenübertragung über die Verbindung zu optimieren. Weitere Informationen zu diesem Protokoll finden Sie unter Übersicht über data Center Bridging.

Hinweis Wenn dieses Flag festgelegt ist, muss der Miniporttreiber alle Sendeanforderungen für DCBX-Pakete ablehnen.

MaxNumTrafficClasses

Ein ULONG Wert, der die maximale Anzahl von NDIS QoS-Datenverkehrsklassen angibt, die der Netzwerkadapter unterstützt. Weitere Informationen finden Sie unter NDIS QoS Traffic Classes.

Hinweis Damit der Netzwerkadapter NDIS QoS für DCB unterstützt, muss er mindestens drei Datenverkehrsklassen unterstützen.

MaxNumEtsCapableTrafficClasses

Ein ULONG- Wert, der die maximale Anzahl von QoS-Datenverkehrsklassen angibt, die der Netzwerkadapter mit dem ETS-Algorithmus (Enhanced Transmission Selection) verwenden kann. Dieser Wert muss kleiner oder gleich dem Wert des MaxNumTrafficClasses Member sein.

Weitere Informationen zu ETS finden Sie unter Enhanced Transmission Selection (ETS)-Algorithmus.

Hinweis Damit der Netzwerkadapter NDIS QoS für DCB unterstützt, muss er mindestens zwei ETS-fähige Datenverkehrsklassen unterstützen.

MaxNumPfcEnabledTrafficClasses

Ein ULONG- Wert, der die maximale Anzahl von QoS-Datenverkehrsklassen angibt, die der Netzwerkadapter mit dem PFC-Algorithmus (Priority-based Flow Control) verwenden kann. Dieser Wert muss kleiner oder gleich dem Wert des MaxNumTrafficClasses Member sein.

Weitere Informationen zu PFC finden Sie unter prioritätsbasierte Flusssteuerung (PFC).

Hinweis Damit der Netzwerkadapter NDIS QoS für DCB unterstützt, muss er mindestens eine PFC-fähige Datenverkehrsklasse unterstützen.

Bemerkungen

Der Miniporttreiber registriert die NDIS QoS-Funktionen des zugrunde liegenden Netzwerkadapters aus der MiniportInitializeEx- funktion des Treibers, indem sie die folgenden Schritte ausführen:

Der Miniporttreiber initialisiert eine NDIS_QOS_CAPABILITIES Struktur mit den NDIS-QoS-Funktionen des Netzwerkadapters.
Der Miniporttreiber initialisiert eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur mit den anderen hardwaregestützten Funktionen des Netzwerkadapters. Der Treiber legt den HardwareQosCapabilities Member der NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur auf einen Zeiger auf die NDIS_QOS_CAPABILITIES-Struktur fest.
Der Miniporttreiber ruft NdisMSetMiniportAttributes auf und legt den MiniportAttributes Parameter auf einen Zeiger auf die NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur fest.

Die NDIS_QOS_CAPABILITIES-Struktur wird auch in OID-Abfrageanforderungen von OID_QOS_CURRENT_CAPABILITIES und OID_QOS_HARDWARE_CAPABILITIESzurückgegeben.