NDIS_QOS_CAPABILITIES-Struktur (ntddndis.h)

Artikel
02/29/2024

Die NDIS_QOS_CAPABILITIES-Struktur gibt die QoS-Funktionen (Quality of Service) von NDIS 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;

Member

Header

Typ, Revision und Größe der NDIS_QOS_CAPABILITIES-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

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

NDIS_QOS_CAPABILITIES_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1 fest.

Flags

Ein ULONG-Wert , der ein bitweises OR von Flags enthält, die die NDIS-QoS-Funktionen angeben, die von einem Netzwerkadapter unterstützt werden. Die folgenden Flags sind definiert:

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

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

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

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

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

NDIS_QOS_CAPABILITIES_CEE_DCBX_SUPPORTED

Wenn dieses Flag festgelegt ist, unterstützen der Netzwerkadapter und der Miniporttreiber die Protokolle, die vor dem DCBX-Protokoll (IEEE 802.1Qaz Data Center Bridging Exchange) stehen. Zu diesen Protokollen gehört die CEE-Protokollsammlung (Converged Enhanced Ethernet).

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

Wenn dieses Flag festgelegt ist, unterstützen der Netzwerkadapter und der Miniporttreiber das DCBX-Protokoll IEEE 802.1Qaz. Das DCBX-Protokoll ermöglicht den Austausch von DCB-Parametern zwischen zwei direkt verbundenen Peers. Dadurch 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 vom Netzwerkadapter unterstützt werden. Weitere Informationen finden Sie unter NDIS QoS-Datenverkehrsklassen.

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-Elements 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-Elements 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.

Hinweise

Der Miniporttreiber registriert die NDIS-QoS-Funktionen des zugrunde liegenden Netzwerkadapters über die MiniportInitializeEx-Funktion des Treibers, indem er die folgenden Schritte ausführt:

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 hardwareunterstü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_CAPABILITIES zurückgegeben.