NDIS_QOS_PARAMETERS structure (ntddndis.h)

Article
08/07/2023

La structure NDIS_QOS_PARAMETERS spécifie les paramètres de qualité de service (QoS) NDIS activés sur une carte réseau qui prend en charge l’interface IEEE 802.1 Data Center Bridging (DCB).

Syntaxe

typedef struct _NDIS_QOS_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              NumTrafficClasses;
  UCHAR              PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES];
  UCHAR              TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  UCHAR              TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              PfcEnable;
  ULONG              NumClassificationElements;
  ULONG              ClassificationElementSize;
  ULONG              FirstClassificationElementOffset;
} NDIS_QOS_PARAMETERS, *PNDIS_QOS_PARAMETERS;

Membres

Header

Type, révision et taille de la structure NDIS_QOS_PARAMETERS . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_QOS_PARAMETERS. Pour spécifier la version de la structure NDIS_QOS_PARAMETERS , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_QOS_PARAMETERS_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Taille sur NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs qui spécifient la status des paramètres de qualité de service NDIS pour la carte réseau. Pour plus d’informations sur ce membre, consultez Vue d’ensemble du membre Indicateurs.

NumTrafficClasses

Valeur ULONG qui spécifie le nombre de classes de trafic NDIS QoS activées sur la carte réseau. Chaque classe de trafic est référencée via un identificateur dans la plage comprise entre zéro et (NumTrafficClasses–1).

Note La valeur du membre NumTrafficClasses doit être inférieure ou égale à min(NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES, MaxNumTrafficClasses), où MaxNumTrafficClasses est la valeur du membre MaxNumTrafficClasses spécifié dans la structure NDIS_QOS_CAPABILITIES .

PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES]

Tableau d’éléments UCHAR où chaque élément représente la classe de trafic associée à un niveau de priorité IEEE 802.1p. Le tableau PriorityAssignmentTable est indexé par le niveau de priorité 802.1p (0-7).

Chaque élément contient l’identificateur de classe de trafic. Cet identificateur est l’index de la structure NDIS_QOS_CLASSIFICATION_ELEMENT pour la classe de trafic dans le tableau de classification.

Note Un identificateur de classe de trafic valide doit être attribué à chaque élément du tableau PriorityAssignmentTable . Un identificateur de classe de trafic peut être affecté à plusieurs éléments dans le tableau PriorityAssignmentTable .

TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Tableau d’éléments UCHAR qui spécifie le pourcentage de l’allocation de bande passante affectée à chaque classe de trafic. Le tableau TcBandwidthAssignmentTable est indexé par l’identificateur de classe de trafic.

Chaque élément du tableau TcBandwidthAssignmentTable spécifie l’allocation de bande passante pour les classes de trafic. La valeur totale de toutes les affectations d’allocation de bande passante dans le tableau TcBandwidthAssignmentTable doit être égale à 100.

Note L’allocation de bande passante est prise en charge uniquement pour la TSA etS (Enhanced Transmission Selection). Si l’élément de la classe de trafic dans le tableau TsaAssignmentTable n’est pas défini sur NDIS_QOS_TSA_ETS, l’élément de la classe de trafic dans le tableau TcBandwidthAssignmentTable doit être défini sur zéro.

TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Tableau d’éléments UCHAR qui spécifie la TSA affectée à chaque classe de trafic. Le tableau TsaAssignmentTable est indexé par l’identificateur de classe de trafic.

Chaque élément du tableau TsaAssignmentTable contient l’une des valeurs suivantes :

NDIS_QOS_TSA_STRICT

L’algorithme de priorité stricte doit être utilisé comme TSA pour la classe de trafic. Pour plus d’informations sur cette TSA, consultez Algorithme de priorité stricte.

NDIS_QOS_TSA_CBS

L’algorithme de modélisateur basé sur le crédit (CBS) IEEE 802.1Qav doit être utilisé en tant que TSA pour la classe de trafic.

Note À compter de Windows Server 2012, le composant DCB (Msdcb.sys) ne prend pas en charge la TSA CBS et n’active pas ce paramètre par le biais des requêtes de méthode d’identificateur d’objet (OID) de OID_QOS_PARAMETERS. Pour plus d’informations sur le composant DCB, consultez Architecture qoS NDIS pour le pontage du centre de données.

NDIS_QOS_TSA_ETS

L’algorithme IEEE 802.1Qaz Enhanced Transmission Selection (ETS) doit être utilisé comme TSA pour la classe de trafic. Pour plus d’informations sur cette TSA, consultez Algorithme de sélection de transmission améliorée (ETS).

PfcEnable

Bitmap de 32 bits. Les 24 bits les plus significatifs sont réservés à une utilisation ultérieure. Les 8 bits les moins significatifs sont utilisés pour spécifier si PFC est activé sur le niveau de priorité IEEE 802.1p. Si le bit est défini sur un, PFC est activé pour le niveau de priorité.

Plage de bits	Signification
31:24	Réservé pour un usage futur.
7	Si la valeur est définie sur un, la PFC est activée sur le niveau de priorité 7 (contrôle réseau) 802.1p.
6	S’il est défini sur un, PFC est activé sur le niveau de priorité 6 802.1p (contrôle internetwork).
5	S’il est défini sur un, PFC est activé sur le niveau de priorité 5 802.1p (voix).
4	S’il est défini sur un, PFC est activé sur le niveau de priorité 4 802.1p (vidéo).
3	Si la valeur est définie sur un, la PFC est activée sur le niveau de priorité 3 802.1p (applications critiques).
2	S’il est défini sur un, PFC est activé sur le niveau de priorité 2 802.1p (excellent effort).
1	Si la valeur est définie sur un, la PFC est activée sur le niveau de priorité 1 802.1p (arrière-plan).
0	Si la valeur est définie sur un, la PFC est activée sur le niveau de priorité 0 802.1p (meilleur effort).

Note Le nombre total de niveaux de priorité de 802,1 p sur 2000 pour 1000 pour 10.000 points de priorité activés doit être inférieur ou égal à la valeur du membre MaxNumPfcEnabledTrafficClasses dans la structure NDIS_QOS_CAPABILITIES .

Pour plus d’informations sur les niveaux de priorité, consultez Niveaux de priorité IEEE 802.1p.

NumClassificationElements

Valeur ULONG qui spécifie le nombre d’éléments dans le tableau de classification du trafic. Le décalage vers le premier élément de ce tableau est spécifié par le membre FirstClassificationElementOffset .

Note Chaque élément du tableau est mis en forme en tant que structure NDIS_QOS_CLASSIFICATION_ELEMENT .

ClassificationElementSize

Valeur ULONG qui spécifie la taille, en octets, de chaque élément du tableau de classification du trafic.

Note À compter de NDIS 6.30, ce membre doit être défini sur sizeof(NDIS_QOS_CLASSIFICATION_ELEMENT).

FirstClassificationElementOffset

Valeur ULONG qui spécifie le décalage, en octets, sur le premier élément d’un tableau d’éléments de classification du trafic qui suivent cette structure. Le décalage est mesuré du début de la structure NDIS_QOS_PARAMETERS jusqu’au début du premier élément. Chaque élément du tableau est une structure NDIS_QOS_CLASSIFICATION_ELEMENT .

Note Si NumClassificationElements est défini sur zéro, ce membre est ignoré.

Remarques

La structure NDIS_QOS_PARAMETERS spécifie les paramètres qui définissent la façon dont la carte réseau hiérarchise les paquets de transmission ou de sortie. Cette structure est utilisée dans les requêtes OID suivantes :

Requête OID de OID_QOS_OPERATIONAL_PARAMETERS. Cette requête OID retourne les paramètres qoS opérationnels qui sont actuellement provisionnés sur la carte réseau.
Requête OID de OID_QOS_REMOTE_PARAMETERS. Cette requête OID retourne les paramètres QoS distants actuellement provisionnés sur la carte réseau.
Demandes de méthode OID de OID_QOS_PARAMETERS. Cette requête OID provisionne la carte réseau avec les paramètres qoS locaux.

Le pilote miniport retourne également une structure NDIS_QOS_PARAMETERS dans les indications de status NDIS suivantes :

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE. Ce pilote miniport émet cette status indication quand ses paramètres qoS opérationnels changent.
NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE. Ce pilote miniport émet cette indication status lorsque ses paramètres qoS distants changent.

Pour plus d’informations sur les types de paramètres de qualité de service NDIS, consultez Vue d’ensemble des paramètres de qualité de service NDIS.

Vue d’ensemble du membre Flags

Le membre Flags contient un OR au niveau du bit d’indicateurs qui spécifient la status des paramètres de qualité de service NDIS pour la carte réseau.

Le pilote miniport définit le membre Flags lorsqu’il émet les indications de status NDIS suivantes :

Le composant DCB définit le membre Flags lorsqu’il émet une demande de méthode OID de OID_QOS_PARAMETERS.

Note Seul le composant DCB peut émettre la requête OID. Un protocole ou un pilote de filtre trop important ne doit pas émettre cet OID. Pour plus d’informations sur le composant DCB, consultez Architecture qoS NDIS pour le pontage du centre de données.

Les indicateurs suivants sont définis pour le membre Flags .

Note NDIS garantit que les indicateurs NDIS_QOS_PARAMETERS_ETS_CONFIGURED et NDIS_QOS_PARAMETERS_PFC_CONFIGURED sont définis ou effacés ensemble.

Les indicateurs NDIS_QOS_PARAMETERS_Xxx_CHANGED indiquent si le groupe de paramètres correspondant a changé à partir d’une demande de méthode OID_QOS_PARAMETERS précédente ou d’une notification NDIS_QOS_PARAMETERS_Xxx_CHANGED status. Lorsque le pilote miniport émet les notifications NDIS_QOS_PARAMETERS_Xxx_CHANGED status, il peut éventuellement définir ces indicateurs.

Note Si les indicateurs de NDIS_QOS_PARAMETERS_Xxx_CHANGED ne sont pas définis, les pilotes de trop ne doivent pas supposer que le groupe de paramètres correspondant est pris en charge ou activé sur la carte réseau sous-jacente.