OID_QOS_CURRENT_CAPABILITIES
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. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |