Freigeben über


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:

  1. Der Treiber initialisiert eine NDIS_QOS_CAPABILITIES-Struktur mit den NDIS QoS-Hardwarefunktionen.

  2. Der Treiber legt den HardwareQosCapabilities-Member der NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur auf einen Zeiger auf die NDIS_QOS_CAPABILITIES-Struktur fest.

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

Weitere Informationen


MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NdisMSetMiniportAttributes

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES