Registrierung der NDIS-QoS-Funktionalitäten

  • Artikel

Miniport-Treiber registrieren während der Initialisierung des Netzwerkadapters die folgenden Funktionalitäten für Quality of Service (QoS) mit NDIS:

  • Die NDIS-QoS-Funktionalitäten, die der Netzwerkadapter unterstützt.

    Hinweis Ab NDIS 6.30 muss der Miniport-Treiber die NDIS-QoS-Hardware-Funktionalitäten, die der Adapter unterstützt, nur dann registrieren, wenn in der Registrierung die *QOS-INF-Schlüsselwort-Einstellung vorhanden ist. In diesem Fall muss der Treiber seine NDIS-QoS-Hardware-Funktionalitäten unabhängig davon registrieren, ob diese Funktionalitäten auf dem Adapter aktiviert oder deaktiviert sind.

  • Die NDIS-QoS-Hardware-Funktionalitäten, die derzeit auf dem Netzwerkadapter aktiviert sind.

    Hinweis Die NDIS-QoS-Hardware-Funktionalitäten eines Miniport-Treibers können über die Einstellung des Schlüsselworts *QOS INF in der Registrierung aktiviert oder deaktiviert werden. Diese Einstellung wird auf der Eigenschaftsseite Erweitert für den Netzwerkadapter angezeigt.

Weitere Informationen über die Einstellungen für das NDIS QoS INF-Schlüsselwort finden Sie unter Standardisierte INF-Schlüsselwörter für NDIS QoS.

Der Miniport-Treiber meldet die Hardware NDIS-QoS-Funktionalitäten des zugrunde liegenden Netzwerkadapters über eine NDIS_QOS_CAPABILITIES-Struktur, die wie folgt initialisiert wird:

  1. Der Miniport-Treiber initialisiert das Header-Mitglied. Der Treiber legt das Type-Mitglied von Header auf NDIS_OBJECT_TYPE_QOS_CAPABILITIES fest.

    Ab NDIS 6.30 legt der Miniport-Treiber das Revision-Mitglied von Header auf NDIS_QOS_CAPABILITIES_REVISION_1 und das Size-Mitglied auf NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1 fest.

  2. Wenn der Netzwerkadapter den strikten Prioritätsübertragungsauswahlalgorithmus (Priority Transmission Selection, TSA) unterstützt, setzt der Miniport-Treiber das Flag NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED im Flags-Mitglied. Weitere Informationen zu diesem Algorithmus finden Sie unter Strict Priority Algorithm.

    Hinweis Ab NDIS 6.30 müssen Miniport-Treiber und Netzwerkadapter, die NDIS QoS für IEEE Data Center Bridging (DCB) unterstützen, die strikte Prioritäts-TSA unterstützen.

  3. Wenn der Netzwerkadapter die Möglichkeit unterstützt, die MACsec-Verarbeitung (Media Access Control Security) zu umgehen, setzt der Miniport-Treiber das Flag NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED im Mitglied Flags. Weitere Informationen über MACsec finden Sie im IEEE 802.1AE-2006-Standard.

    Hinweis Ab NDIS 6.30 muss der Netzwerkadapter die Umgehung der MACsec-Verarbeitung nicht mehr unterstützen.

  4. Der Miniport-Treiber legt das Mitglied MaxNumTrafficClasses auf die maximale Anzahl der NDIS-QoS-Datenverkehrsklassen fest, die der Netzwerkadapter unterstützt. Eine Datenverkehrsklasse definiert die Transmit- oder Egress-Richtlinien für QoS, wie z. B. die IEEE 802.1p-Prioritätsstufe und die Bandbreitenzuweisung. Weitere Informationen über Datenverkehrsklassen finden Sie unter NDIS QoS Traffic Classes.

    Hinweis Ab NDIS 6.30 muss der Netzwerkadapter mindestens drei Datenverkehrsklassen unterstützen.

  5. Der Miniport-Treiber legt das Mitglied MaxNumEtsCapableTrafficClasses auf die maximale Anzahl der NDIS QoS-Datenverkehrsklassen fest, die der Netzwerkadapter mit dem Enhanced Transmission Selection (ETS)-Algorithmus verwenden kann. Dieser Wert muss kleiner als oder gleich dem Wert des MaxNumTrafficClasses-Mitglieds sein.

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

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

  6. Der Miniport-Treiber legt das Mitglied MaxNumPfcEnabledTrafficClasses auf die maximale Anzahl von NDIS QoS-Datenverkehrsklassen fest, die der Netzwerkadapter mit dem Priority-based Flow Control (PFC)-Algorithmus verwenden kann. Dieser Wert muss kleiner als oder gleich dem Wert des MaxNumTrafficClasses-Mitglieds sein.

    Weitere Informationen zu PFC finden Sie unter Priority-based Flow Control (PFC).

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

Wenn NDIS die Funktion MiniportInitializeEx des Miniport-Treibers aufruft, registriert der Treiber die NDIS QoS-Attribute des Netzwerkadapters, indem er die folgenden Schritte ausführt:

  1. Der Miniport-Treiber initialisiert eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur.

    Der Miniport-Treiber legt das HardwareQOSCapabilities-Mitglied auf einen Zeiger auf die zuvor initialisierte NDIS_QOS_CAPABILITIES-Struktur fest.

    Wenn die Registrierungseinstellung für das *QOS INF-Schlüsselwort den Wert 1 hat, sind die NDIS-QoS-Funktionalitäten für den Netzwerkadapter aktiviert. Der Miniport-Treiber legt die CurrentQOSCapabilities-Mitglieder auf einen Zeiger auf dieselbe NDIS_QOS_CAPABILITIES-Struktur fest.

    Wenn die Registrierungseinstellung für das *QOS INF-Schlüsselwort einen Wert 0 hat, sind die NDIS-QoS-Funktionalitäten für den Netzwerkadapter deaktiviert. Der Miniport-Treiber muss das CurrentQOSCapabilities-Mitglied auf NULL festlegen.

  2. Der Treiber ruft NdisMSetMiniportAttributes auf und setzt den Parameter MiniportAttributes auf einen Zeiger auf die Struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Weitere Informationen über den Initialisierungsprozess des Adapters finden Sie unter Initialisierung eines Miniport-Adapters.