OID_QOS_OPERATIONAL_PARAMETERS

Artikel
06/15/2023

Ein Überlastungstreiber gibt eine Objektbezeichnerabfrageanforderung (Object Identifier, OID) von OID_QOS_OPERATIONAL_PARAMETERS aus, um die aktuellen QoS-Betriebsparameter (NDIS Quality of Service) für einen Netzwerkadapter abzurufen. Der Miniporttreiber konfiguriert den Netzwerkadapter mit den operativen NDIS-QoS-Parametern, um die QoS-Paketübertragung durchzuführen.

Nach erfolgreicher Rückgabe der OID-Abfrageanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_QOS_PARAMETERS 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

Wenn NDIS die OID-Abfrageanforderung von OID_QOS_OPERATIONAL_PARAMETERS erfolgreich verarbeitet, gibt es die operativen NDIS-QoS-Parameter zurück, die es aus dem vorherigen NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE status Vom Miniporttreiber ausgegebenen Hinweis zwischengespeichert hatte. Der Treiber gibt diesen status Hinweis aus, um den anfänglichen Satz operativer NDIS-QoS-Parameter zu melden. Der Treiber gibt auch diese status Angabe aus, wenn sich die operativen NDIS-QoS-Parameter ändern.

NDIS gibt eine NDIS_QOS_PARAMETERS-Struktur zurück, die wie folgt initialisiert wird:

Wenn der Miniporttreiber zuvor eine NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE status Indikation ausgegeben hat, speichert NDIS die NDIS_QOS_PARAMETERS Daten zwischen und gibt diese Daten für die OID-Abfrageanforderung von OID_QOS_OPERATIONAL_PARAMETERS zurück.
Wenn der Miniporttreiber keine NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE status Angabe ausgegeben hat, gibt NDIS eine NDIS_QOS_PARAMETERS-Struktur zurück, bei der alle Member (mit Ausnahme des Headerelements) auf null festgelegt sind.

Weitere Informationen zu operativen NDIS-QoS-Parametern finden Sie unter Übersicht über NDIS-QoS-Parameter.

Rückgabestatuscodes

NDIS 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_PARAMETERS). 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.