OID_QOS_PARAMETERS

Die DCB-Komponente (Data Center Bridging) (Msdcb.sys) gibt eine OID-Methodenanforderung (Object Identifier) von OID_QOS_PARAMETERS aus, um die lokalen QoS-Parameter (Quality of Service) von NDIS auf einem Netzwerkadapter zu konfigurieren.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_QOS_PARAMETERS-Struktur .

Hinweis Diese Anforderung der OID-Methode ist obligatorisch für Miniporttreiber, die NDIS QoS für die IEEE 802.1 Data Center Bridging-Schnittstelle (DCB) unterstützen.

Bemerkungen

Miniport-Treiber erhalten die lokalen NDIS-QoS-Parameter über eine OID-Methodenanforderung von OID_QOS_PARAMETERS. Diese Parameter definieren, wie der Netzwerkadapter die Übertragung oder ausgehende Pakete priorisiert. Weitere Informationen zu diesen Parametern finden Sie unter Übersicht über NDIS-QoS-Parameter.

Hinweis Nur die DCB-Komponente kann eine OID-Methodenanforderung von OID_QOS_PARAMETERS ausgeben. Ein übermäßiger Protokoll- oder Filtertreiber darf diese OID nicht ausgeben. Weitere Informationen zur DCB-Komponente finden Sie unter NDIS QoS Architecture for Data Center Bridging.

Die DCB-Komponente gibt unter den folgenden Bedingungen eine OID_QOS_PARAMETERS-Anforderung aus:

  • Der Systemadministrator installiert oder deinstalliert das Microsoft DCB-Serverfeature.

    Weitere Informationen zum DCB-Serverfeature finden Sie unter Vom System bereitgestellte DCB-Komponenten.

  • Der Systemadministrator aktiviert oder deaktiviert das DCB-Serverfeature, während das Feature noch installiert ist.

  • Der Systemadministrator ändert alle Featureparameter des DCB-Servers.

  • Das Betriebssystem wird gestartet oder neu gestartet, während das DCB-Serverfeature installiert ist.

Wenn der Miniporttreiber die OID-Methodenanforderung von OID_QOS_PARAMETERS verarbeitet, muss er die folgenden Richtlinien befolgen:

  • Der Miniporttreiber kopiert die Daten innerhalb der NDIS_QOS_PARAMETERS-Struktur in den Cache der lokalen NDIS-QoS-Parameter. Der Treiber löst dann seine operativen NDIS-QoS-Parameter basierend auf seinem Cache aus lokalen NDIS-QoS-Parametern und seinem Cache von NDIS-QoS-Parametern auf, die er von einem Remotepeer empfangen hat.

    Weitere Informationen dazu, wie der Miniporttreiber seine Betriebsparameter auflöst, finden Sie unter Auflösen von operativen NDIS-QoS-Parametern.

  • Der Miniporttreiber darf keine Daten ändern, die in der NDIS_QOS_PARAMETERS-Struktur enthalten sind. Der Treiber muss die OID-Methodenanforderung abschließen und die ursprünglichen Daten innerhalb der NDIS_QOS_PARAMETERS-Struktur zurückgeben.

  • Das flag NDIS_QOS_PARAMETERS_WILLING gibt an, ob der Miniporttreiber den lokalen DCBX-Zustand (Data Center Bridging Exchange) Will-Zustand aktiviert oder deaktiviert. Der Treiber behandelt dieses Flag wie folgt:

    • Wenn dieses Flag festgelegt ist, muss der Miniporttreiber den lokalen DCBX Willing-Zustand aktivieren. Dadurch kann der Treiber remote mit QoS-Einstellungen konfiguriert werden. In diesem Fall löst der Treiber seine operativen QoS-Parameter basierend auf den QoS-Remoteparametern auf. Der Miniporttreiber kann auch seine betriebsbereiten QoS-Parameter basierend auf proprietären QoS-Einstellungen auflösen, die vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) definiert werden.

    • Wenn dieses Flag nicht festgelegt ist, muss der Miniporttreiber den lokalen DCBX Willing-Zustand deaktivieren. Dadurch kann der Treiber seine operativen QoS-Parameter aus seinen lokalen QoS-Parametern anstelle von Remote-QoS-Parametern auflösen. Der Miniporttreiber muss auch alle lokalen QoS-Parameter deaktivieren oder überschreiben, für die das zugehörige flag NDIS_QOS_PARAMETERS_Xxx_CONFIGURED nicht festgelegt ist.

      Der Miniporttreiber kann beispielsweise einen nicht konfigurierten lokalen QoS-Parameter mit seinen proprietären Einstellungen für den QoS-Parameter überschreiben, der vom IHV definiert wird. Wenn keine proprietären Einstellungen für lokale QoS-Parameter vorhanden sind, die nicht mit einem NDIS_QOS_PARAMETERS_Xxx_CONFIGURED-Flag angegeben sind, muss der Treiber die Verwendung dieser QoS-Parameter auf dem Netzwerkadapter deaktivieren.

      Hinweis Der Treiber kann auch konfigurierte lokale QoS-Parameter außer Kraft setzen, wenn sie die QoS-Parameter kompromittieren, die von Protokollen oder Technologien verwendet werden, die auf dem Netzwerkadapter aktiviert sind. Der Treiber kann beispielsweise die lokalen QoS-Parameter überschreiben, wenn der Netzwerkadapter für den Remotestart über das Fibre Channel over Ethernet-Protokoll (FCoE) aktiviert ist.

    Weitere Informationen zum lokalen DCBX Willing-Zustand finden Sie unter Verwalten des lokalen DCBX Willing-Zustands.

Weitere Informationen dazu, wie der Miniporttreiber lokale QoS-Parameter überschreibt, finden Sie unter Verwalten von NDIS-QoS-Parametern.

Hinweis Das Überschreiben der lokalen QoS-Parameter sollte nicht dazu führen, dass der Miniporttreiber die OID-Methodenanforderung von OID_QOS_PARAMETERS fehlschlägt.

Weitere Informationen dazu, wie der Miniporttreiber die lokalen QoS-Parameter verwaltet, finden Sie unter Festlegen lokaler NDIS-QoS-Parameter.

Zurückgeben von Statuscodes

Der Miniporttreiber gibt einen der folgenden status-Codes zurück.

Statuscode BESCHREIBUNG

NDIS_STATUS_SUCCESS

Die OID-Anforderung wurde erfolgreich abgeschlossen.

NDIS_STATUS_PENDING

Die OID-Anforderung steht noch aus. Wenn der Miniporttreiber NdisMOidRequestComplete aufruft, übergibt NDIS den endgültigen status Code und die Ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen wurde.

NDIS_STATUS_NOT_SUPPORTED

Der Miniporttreiber unterstützt die NDIS-QoS-Schnittstelle nicht.

NDIS_STATUS_INVALID_PARAMETER

Mindestens ein Element der NDIS_QOS_PARAMETERS-Struktur enthält falsche Werte.

NDIS_STATUS_INVALID_LENGTH

Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_QOS_PARAMETERS). NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE

Die Anforderung ist aus anderen Gründen fehlgeschlagen.

Requirements (Anforderungen)

Version

Unterstützt in NDIS 6.30 und höher.

Header

Ntddndis.h (include Ndis.h)

Weitere Informationen


NdisMOidRequestComplete

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE