OID_QOS_HARDWARE_CAPABILITIES
Ein Überlastungstreiber gibt eine Objektbezeichnerabfrageanforderung (Object Identifier, OID) von OID_QOS_HARDWARE_CAPABILITIES aus, um die 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
Die NDIS_QOS_CAPABILITIES-Struktur enthält Informationen zu den NDIS-QoS-Hardwarefunktionen eines Netzwerkadapters. Diese Funktionen können Hardwarefunktionen enthalten, die derzeit durch INF-Dateieinstellungen oder über die Seite Erweiterte Eigenschaften deaktiviert sind.
Hinweis Alle NDIS QoS-Hardwarefunktionen eines Netzwerkadapters werden über eine OID-Abfrageanforderung von OID_QOS_HARDWARE_CAPABILITIES zurückgegeben, unabhängig davon, ob eine Funktion aktiviert oder deaktiviert ist.
Miniport-Treiber registrieren die NDIS QoS-Hardwarefunktionen eines Netzwerkadapters, wenn die 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 NDIS QoS-Hardwarefunktionen.
Der Treiber legt den HardwareQosCapabilities-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 NDIS-QoS-Hardwarefunktionen eines Netzwerkadapters, um Protokoll- und Filtertreiber während der Bindungs- oder Anfügevorgänge zu überlisten.
Weitere Informationen zum Registrieren von NDIS-QoS-Funktionen finden Sie unter Registrieren von NDIS-QoS-Funktionen.
Rückgabestatuscodes
NDIS verarbeitet die OID-Abfrageanforderung OID_QOS_HARDWARE_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) |