OID_QOS_REMOTE_PARAMETERS

Artikel
06/15/2023

Ein übermäßiger Treiber gibt eine OID-Abfrageanforderung (Object Identifier) von OID_QOS_REMOTE_PARAMETERS aus, um die QoS-Parameter (Quality of Service) von NDIS für einen Remotepeer abzurufen. Der Miniporttreiber verwendet diese Remote-QoS-Parameter, um seine betriebsbereiten NDIS-QoS-Parameter aufzulösen. Der Treiber konfiguriert den Netzwerkadapter mit den Betriebsparametern, um die QoS-Paketübertragung durchzuführen.

Nach einer erfolgreichen Rückgabe von 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 ist nur für Miniporttreiber gültig, die die IEEE 802.1 Data Center Bridging-Schnittstelle (DCB) unterstützen.

Bemerkungen

Wenn NDIS die OID-Anforderung von OID_QOS_REMOTE_PARAMETERS erfolgreich verarbeitet, gibt sie die NDIS-QoS-Remoteparameter zurück, die sie aus dem vorherigen NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE status Vom Miniporttreiber ausgegebenen Angabe zwischengespeichert hatte. Der Treiber gibt diese status Angabe aus, um den anfänglichen Satz von NDIS-QoS-Parametern zu melden. Der Treiber gibt auch diese status-Anzeige aus, wenn sich die NDIS-QoS-Remoteparameter ändern.

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

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

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

Zurückgeben von Statuscodes

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. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_FAILURE	Die Anforderung ist aus anderen Gründen fehlgeschlagen.