OID_QOS_CURRENT_CAPABILITIES

Artikel
06/15/2023

Ein Überlastungstreiber gibt eine Objektbezeichnerabfrageanforderung (Object Identifier, OID) von OID_QOS_CURRENT_CAPABILITIES aus, um die derzeit aktivierten QoS-Hardwarefunktionen (NDIS Quality of Service) eines Netzwerkadapters abzurufen.

Nach erfolgreicher Rückgabe der OID-Abfrageanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_QOS_CAPABILITIES-Struktur .

Hinweis Diese OID-Abfrageanforderung wird von NDIS für Miniporttreiber verarbeitet, die die DCB-Schnittstelle (IEEE 802.1 Data Center Bridging) unterstützen.

Bemerkungen

Miniport-Treiber registrieren die derzeit aktivierten NDIS QoS-Hardwarefunktionen eines Netzwerkadapters, wenn dessen MiniportInitializeEx-Funktion aufgerufen wird. Der Treiber registriert diese Funktionen, indem er die folgenden Schritte ausführt:

Der Treiber initialisiert eine NDIS_QOS_CAPABILITIES-Struktur mit den aktivierten QoS-Hardwarefunktionen.
Der Treiber legt den CurrentQosCapabilities-Member der NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur auf einen Zeiger auf die NDIS_QOS_CAPABILITIES-Struktur fest.
Der Miniporttreiber ruft dann die NdisMSetMiniportAttributes-Funktion auf und legt den MiniportAttributes-Parameter auf einen Zeiger auf eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur fest.

Hinweis NDIS meldet nicht die derzeit aktivierten NDIS QoS-Hardwarefunktionen eines Netzwerkadapters, um Protokoll- und Filtertreiber während der Bindungs- oder Anfügevorgänge zu überlasten.

Weitere Informationen zum Registrieren von NDIS-QoS-Funktionen finden Sie unter Registrieren von NDIS-QoS-Funktionen.

Rückgabestatuscodes

NDIS verarbeitet die OID-Abfrageanforderung von OID_QOS_CURRENT_CAPABILITIES Anforderung für Miniporttreiber und gibt einen der folgenden status-Codes zurück.

Statuscode	BESCHREIBUNG
NDIS_STATUS_SUCCESS	Die OID-Anforderung wurde erfolgreich abgeschlossen.
NDIS_STATUS_NOT_SUPPORTED	Der Miniporttreiber unterstützt die NDIS-QoS-Schnittstelle nicht.
NDIS_STATUS_INVALID_LENGTH	Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_QOS_CAPABILITIES). NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_FAILURE	Die Anforderung ist aus anderen Gründen fehlgeschlagen.