Het aangeven van wijzigingen in de operationele NDIS QoS-parameters

Het minipoortstuurprogramma dat NDIS Quality of Service (QoS) ondersteunt, geeft een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusaanduiding op wanneer de operationele NDIS QoS-parameters van het stuurprogramma voor het eerst worden opgelost of wanneer ze later worden gewijzigd. Het minipoortstuurprogramma configureert de netwerkadapter met deze operationele parameters om QoS-pakkettransmissie uit te voeren.

Het miniport-stuurprogramma moet de volgende richtlijnen volgen voor het uitgeven van een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie:

• Het minipoortstuurprogramma moet een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie geven nadat deze de operationele NDIS QoS-parameters heeft opgelost en de netwerkadapter ermee heeft geconfigureerd.

  Opmerking Als het minipoortstuurprogramma is ingericht met eigen lokale NDIS QoS-parameters in het register, moet het stuurprogramma een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie geven tijdens of direct na de aanroep naar MiniportInitializeEx. In dit geval initialiseert het stuurprogramma een NDIS_QOS_PARAMETERS structuur met de eigen lokale NDIS QoS-parameterinstellingen.

  Voor meer informatie over hoe het stuurprogramma de operationele NDIS QoS-parameterinstellingen bepaalt, zie Operational NDIS QoS Parameters.

• Na deze initiële statusindicatie moet het minipoortstuurprogramma een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie geven wanneer de operationele NDIS QoS-parameters worden gewijzigd. De operationele NDIS QoS-parameters kunnen bijvoorbeeld worden gewijzigd onder de volgende voorwaarden:

  • De operationele NDIS QoS-parameters worden gewijzigd vanwege wijzigingen in de lokale NDIS QoS-parameters. Deze parameters kunnen veranderen via een OID-methodeaanvraag van OID_QOS_PARAMETERS of via een beheertoepassing die is ontwikkeld door de onafhankelijke hardwareleverancier (IHV).

  • De operationele NDIS QoS-parameters veranderen vanwege conflicten met de QoS-instellingen van de externe peer.

    Het minipoortstuurprogramma gebruikt het IEEE 802.1Qaz Data Center Bridging Exchange-protocol (DCBX) om de QoS-parameters voor een externe peer te detecteren. Als de status DCBX Willing is ingeschakeld, moet het stuurprogramma de verschillen tussen de QoS-parameters en de QoS-parameters van de externe peer oplossen door de procedures te volgen die zijn gedefinieerd voor de DCBX-statusengine. Raadpleeg de conceptstandaard IEEE 802.1Qaz voor meer informatie over deze statusengine.

    Zie voor meer informatie over de lokale DCBX Willing State De lokale DCBX Willing State beheren.

  Opmerking Wanneer het minipoortstuurprogramma lokale of externe NDIS QoS-parameters ontvangt, moet er geen NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie worden opgegeven als er geen wijzigingen zijn aangebracht in de operationele NDIS QoS-parameters. Als het stuurprogramma deze onnodige statusindicatie maakt, geeft NDIS de indicatie mogelijk niet door aan overliggende stuurprogramma's.

• Het minipoortstuurprogramma moet een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusaanduiding geven wanneer deze de lokale NDIS QoS-parameters moet overschrijven die zijn gebruikt om de operationele NDIS QoS-parameters op te lossen.

  Het minipoortstuurprogramma meldt NDIS en het overliggende stuurprogramma dat het de lokale NDIS QoS-parameters heeft overschreven door een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie uit te geven. Voor dit type indicatie moet de bestuurder de juiste NDIS_QOS_PARAMETERS_Xxx_CHANGED vlaggen instellen in het Vlaggen element van de NDIS_QOS_PARAMETERS structuur om de reden voor het overschrijven van de lokale NDIS QoS-parameters op te geven.

  Zie Lokale NDIS QoS-parameters instellenvoor meer informatie over hoe het minipoortstuurprogramma de lokale QoS-parameters beheert.

  Voor meer informatie over hoe het minipoortstuurprogramma de operationele QoS-parameters afhandelt, zie Operational NDIS QoS-parameters afhandelen.

Opmerking Het minipoortstuurprogramma moet NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicaties uitgeven als de NDIS QoS-mogelijkheden momenteel zijn ingeschakeld via het *QOS trefwoord gestandaardiseerde INF-trefwoord. Zie Gestandaardiseerde INF-trefwoorden voor NDIS QoSvoor meer informatie.

Richtlijnen voor het uitgeven van de NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie

Het minipoortstuurprogramma volgt deze stappen wanneer de NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie wordt uitgegeven:

1. Het minipoortstuurprogramma wijst een buffer toe die groot genoeg is om het volgende te bevatten:

   • Een NDIS_QOS_PARAMETERS structuur met de NDIS QoS-configuratie-instellingen en globale operationele parameters voor de NDIS QoS-verkeersklassen.

   • Een matrix van NDIS_QOS_CLASSIFICATION_ELEMENT structuren. Elk van deze structuren specificeert een verkeersclassificatie zoals gedefinieerd door een pakketgegevenspatroon (voorwaarde) en het bijbehorende IEEE 802.1p-prioriteitsniveau (actie). Als de netwerkadapter een patroon vindt in het verzonden of uitgaandpakket dat aan een voorwaarde voldoet, wordt het bijbehorende prioriteitsniveau aan het pakket toegewezen. De adapter past ook het andere NDIS QoS-beleid toe op het pakket op basis van het prioriteitsniveau.

2. De minipoort initialiseert de NDIS_QOS_PARAMETERS structuur met de operationele NDIS QoS-parameters. Het stuurprogramma moet de volledige set operationele parameters opgeven, inclusief de parameters die mogelijk niet op de netwerkadapter zijn geconfigureerd.

   Wanneer het minipoortstuurprogramma het Header-lid initialiseert, stelt het het Type-lid van Header in op NDIS_OBJECT_TYPE_QOS_PARAMETERS. Het minipoortstuurprogramma stelt het Revisie--element van de Header- in op NDIS_QOS_PARAMETERS_REVISION_1 en het Grootte--element op NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1.

   Het minipoortstuurprogramma stelt de juiste NDIS_QOS_PARAMETERS_Xxx_CHANGED vlaggen in het veld Vlaggen in als de bijbehorende velden gewijzigde gegevens bevatten sinds het minipoortstuurprogramma een NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie heeft uitgegeven.

   Opmerking Het instellen van de NDIS_QOS_PARAMETERS_Xxx_CHANGED vlaggen is optioneel. NDIS gaat er altijd vanuit dat de leden van de NDIS_QOS_PARAMETERS actueel zijn, zelfs als ze niet zijn gewijzigd van de vorige NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE statusindicatie.

   Zie voor meer informatie over het instellen van de Flags, Richtlijnen voor het instellen van de Flags Member.

3. Het minipoortstuurprogramma initialiseert een NDIS_QOS_CLASSIFICATION_ELEMENT structuur voor elke netwerkverkeersclassificatie vanuit de operationele NDIS QoS-parameters. Het stuurprogramma voegt deze elementen toe aan het einde van de NDIS_QOS_PARAMETERS structuur in de buffer.

   Opmerking Het minipoortstuurprogramma mag de vlag NDIS_QOS_CLASSIFICATION_ENFORCED_BY_MINIPORT niet instellen in het Vlaggen lid van een NDIS_QOS_CLASSIFICATION_ELEMENT structuur.

   Het stuurprogramma stelt het NumClassificationElements lid van het NDIS_QOS_PARAMETERS structuur in op het aantal classificatie-elementen in de array. Het stuurprogramma configureert het FirstClassificationElementOffset-lid met de byte-offset van het eerste element vanaf het begin van de buffer. Het stuurprogramma stelt ook het ClassificationElementSize lid in op de lengte, in bytes, van elk element in de matrix.

   Opmerking Vanaf NDIS 6.30 moet het minipoortstuurprogramma het ClassificationElementSize lid instellen op sizeof(NDIS_QOS_CLASSIFICATION_ELEMENT).

4. Het minipoortstuurprogramma initialiseert een NDIS_STATUS_INDICATION structuur voor de statusindicatie op de volgende manier:

   • De StatusCode element moet worden ingesteld op NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE.

   • De StatusBuffer-lid moet worden ingesteld op een aanwijzer naar de buffer die de operationele NDIS QoS-parameters bevat.

   • De StatusBufferSize- lid moet worden ingesteld op de lengte, in bytes, van de buffer.

5. Het minipoortstuurprogramma geeft de statusaanduiding door NdisMIndicateStatusEx-aan te roepen. Het stuurprogramma moet een verwijzing naar de NDIS_STATUS_INDICATION structuur naar de parameter StatusIndication geven.

Richtlijnen voor het instellen van het vlaggenlid

Het minipoortstuurprogramma stelt de volgende vlaggen in de Vlaggen lid van de NDIS_QOS_PARAMETERS structuur om op te geven welke operationele NDIS QoS-parameters zijn geconfigureerd of gewijzigd op de netwerkadapter:

NDIS_QOS_PARAMETERS_ETS_CONFIGURED
Als deze vlag is ingesteld, heeft het minipoortstuurprogramma de netwerkadapter geconfigureerd met de ETS-parameters in de volgende leden:

• NumTrafficClasses

• PrioriteitToewijzingstabel

• TcBandbreedteToewijzingstabel

• TsaAssignmentTable -

Opmerking Het minipoortstuurprogramma moet ETS ondersteunen om NDIS QoS voor DCB te ondersteunen. De instelling van deze vlag geeft echter niet op of de netwerkadapter ETS ondersteunt. In plaats daarvan geeft de instelling van deze vlag alleen aan of ETS-parameters zijn geconfigureerd op de netwerkadapter.

NDIS_QOS_PARAMETERS_ETS_CHANGED
Als deze vlag is ingesteld, zijn een of meer ETS-parameters gewijzigd in de volgende leden:

• NumTrafficClasses

• PrioriteitsToewijzingTabel

• TcBandbreedteToewijzingstabel

• TsaAssignmentTable -

NDIS_QOS_PARAMETERS_PFC_CONFIGURED
Als deze vlag is ingesteld, heeft het miniportstuurprogramma de netwerkadapter geconfigureerd met de PFC-instellingen zoals gespecificeerd in het PfcEnable lid.

Opmerking Het minipoortstuurprogramma moet PFC ondersteunen om NDIS QoS voor DCB te ondersteunen. De instelling van deze vlag geeft niet op of de netwerkadapter PFC ondersteunt. In plaats daarvan geeft de instelling van deze vlag alleen aan of PFC-parameters zijn ingeschakeld op de netwerkadapter.

NDIS_QOS_PARAMETERS_PFC_CHANGED
Als deze vlag is ingesteld, zijn één of meer PFC-instellingen gewijzigd in het lid PfcEnable.

NDIS_QOS_PARAMETERS_CLASSIFICATION_CONFIGURED
Als deze vlag is ingesteld, heeft het minipoortstuurprogramma de netwerkadapter geconfigureerd met de QoS-verkeersclassificatieparameters die zijn opgegeven in de volgende leden:

• NumClassificationElements

• ClassificationElementSize

• FirstClassificationElementOffset

NDIS_QOS_PARAMETERS_CLASSIFICATION_CHANGED
Als deze vlag is ingesteld, zijn een of meer QoS-verkeersclassificatieparameters gewijzigd in de volgende leden:

• NumClassificationElements

• ClassificationElementSize

• FirstClassificationElementOffset

Opmerking De NDIS_QOS_PARAMETERS_Xxx_CONFIGURED vlaggen moeten worden ingesteld als de NDIS_QOS_PARAMETERS structuur NDIS QoS-parameterinstellingen bevat. Het minipoortstuurprogramma moet deze vlaggen instellen, ongeacht of de instellingen zijn gewijzigd. Het stuurprogramma moet echter alleen de NDIS_QOS_PARAMETERS_Xxx_CHANGED vlaggen instellen voor de instellingen die zijn gewijzigd.