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) |