OID_QOS_REMOTE_PARAMETERS

2025-03-13

Een overliggend stuurprogramma geeft een OID-queryaanvraag (Object Identifier) van OID_QOS_REMOTE_PARAMETERS op om de QoS-parameters (NDIS Quality of Service) voor een externe peer te verkrijgen. Het minipoortstuurprogramma gebruikt deze externe QoS-parameters om de operationele NDIS QoS-parameters op te lossen. Het stuurprogramma configureert de netwerkadapter met de operationele parameters om QoS-pakketoverdracht uit te voeren.

Nadat de OID-queryaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een NDIS_QOS_PARAMETERS-structuur.

Opmerking Deze OID-queryaanvraag is alleen geldig voor minipoortstuurprogramma's die ondersteuning bieden voor de DCB-interface (IEEE 802.1 Data Center Bridging).

Opmerkingen

Wanneer NDIS de OID-aanvraag van OID_QOS_REMOTE_PARAMETERS met succes afhandelt, worden de externe NDIS QoS-parameters geretourneerd die zijn opgeslagen in de cache van de vorige NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE statusindicatie die is uitgegeven door het minipoortstuurprogramma. Het stuurprogramma geeft deze statusindicatie uit om te rapporteren over de eerste set externe NDIS QoS-parameters. Het stuurprogramma geeft deze statusindicatie ook wanneer de externe NDIS QoS-parameters veranderen.

NDIS retourneert een NDIS_QOS_PARAMETERS structuur die op de volgende manier wordt geïnitialiseerd:

Als het minipoortstuurprogramma eerder een NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE statusindicatie heeft uitgegeven, slaat NDIS de NDIS_QOS_PARAMETERS gegevens op en retourneert deze gegevens voor de OID-queryaanvraag van OID_QOS_REMOTE_PARAMETERS.
Als het minipoortstuurprogramma geen NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE statusindicatie heeft opgegeven, retourneert NDIS een NDIS_QOS_PARAMETERS structuur met alle leden (met uitzondering van de Header lid) ingesteld op nul.

Zie Overzicht van NDIS QoS-parametersvoor meer informatie over externe NDIS QoS-parameters.

Statuscodes retourneren

NDIS retourneert een van de volgende statuscodes.

Statuscode	Beschrijving
NDIS_STATUS_SUCCESS	De OID-aanvraag is voltooid.
NDIS_STATUS_NOT_SUPPORTED	Het minipoortstuurprogramma biedt geen ondersteuning voor de NDIS QoS-interface.
NDIS_STATUS_INVALID_LENGTH	De lengte van de informatiebuffer is kleiner dan de grootte (NDIS_QOS_PARAMETERS). NDIS stelt de DATA in. QUERY_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist.
NDIS_STATUS_FAILURE	De aanvraag is om andere redenen mislukt.