structure NDIS_QOS_CLASSIFICATION_ELEMENT (ntddndis.h)

Article
03/08/2023

La structure NDIS_QOS_CLASSIFICATION_ELEMENT spécifie une classification du trafic NDIS Quality of Service (QoS) pour une carte réseau qui prend en charge l’interface IEEE 802.1 Data Center Bridging (DCB).

Chaque classification du trafic spécifie les éléments suivants :

Une condition de classification basée sur un modèle de données au sein des données de paquet de sortie.
À compter de NDIS 6.30, les conditions de classification sont basées sur une valeur 16 bits, telle qu’un port de destination UDP ou TCP ou un contrôle d’accès multimédia (MAC).
Une action de classification qui définit la classe de trafic à utiliser pour gérer le paquet de sortie.
À compter de NDIS 6.30, les actions de classification spécifient un niveau de priorité 802.1p.

Par exemple, une classification du trafic peut spécifier que tous les paquets de sortie pour le numéro de port TCP de destination 3260 (condition) reçoivent un niveau de priorité 802.1p 3 (action).

Syntaxe

typedef struct _NDIS_QOS_CLASSIFICATION_ELEMENT {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             ConditionSelector;
  USHORT             ConditionField;
  USHORT             ActionSelector;
  USHORT             ActionField;
} NDIS_QOS_CLASSIFICATION_ELEMENT, *PNDIS_QOS_CLASSIFICATION_ELEMENT;

Membres

Header

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

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

NDIS_QOS_CLASSIFICATION_ELEMENT_REVISION_1

Version d’origine de NDIS 6.30.

Définissez le membre taille sur NDIS_SIZEOF_QOS_CLASSIFICATION_ELEMENT_REVISION_1.

Flags

Valeur de ULONG qui contient un OR au niveau du bit des indicateurs qui spécifient l’état des classifications de trafic NDIS QoS qu’un pilote miniport prend en charge. Les indicateurs suivants sont définis :

NDIS_QOS_CLASSIFICATION_ENFORCED_BY_MINIPORT

Si cet indicateur est défini, le pilote miniport accepte les paramètres de classification du trafic spécifiés dans la structure NDIS_QOS_CLASSIFICATION_ELEMENT. Si le pilote accepte les paramètres, il doit configurer la carte réseau pour effectuer la classification du trafic, comme spécifié par les paramètres.

Remarque Cet indicateur est défini uniquement dans les structures NDIS_QOS_CLASSIFICATION_ELEMENT que le pilote miniport retourne à NDIS à partir d’une requête de méthode OID OID_QOS_PARAMETERS.

ConditionSelector

Valeur USHORT qui spécifie le type du modèle de données contenu dans le membre ConditionField. Par exemple, le type de modèle de données peut spécifier un port UDP de destination dont la valeur est spécifiée par le membre ConditionField.

Pour plus d’informations, consultez Instructions pour définir les membres ConditionSelector et ConditionField.

ConditionField

Valeur USHORT qui contient le modèle de données dont le type est spécifié par le membre ConditionSelector.

Pour plus d’informations, consultez Instructions pour définir les membres ConditionSelector et ConditionField.

ActionSelector

Valeur USHORT qui spécifie le type de données d’action contenues dans le membre ActionField. À compter de NDIS 6.30, le type de données d’action spécifie un niveau de priorité 802.1p dont la valeur est spécifiée par le membre ConditionField.

Pour plus d’informations, consultez Instructions pour définir les membres ActionSelector et ActionField.

ActionField

Valeur USHORT qui contient une valeur d’action dont le type est spécifié par le membre ActionSelector.

Pour plus d’informations, consultez Instructions pour définir les membres ActionSelector et ActionField.

Remarques

Une classification du trafic spécifie une condition de et une action de que la carte réseau s’applique aux données de paquets de sortie. Lorsque l’adaptateur inspecte les données de paquets de sortie et trouve une condition de classification correspondante, elle applique l’action correspondante au paquet de sortie.

Remarque À partir de NDIS 6.30, toutes les actions sont basées sur les niveaux de priorité 802.1p. Toutefois, une fois que la carte réseau détermine le niveau de priorité, elle doit utiliser les stratégies de sortie pour la classe de trafic NDIS QoS associée au niveau de priorité. L’association des niveaux de priorité aux classes de trafic est spécifiée dans la structure NDIS_QOS_PARAMETERS.

La structure NDIS_QOS_CLASSIFICATION_ELEMENT spécifie chaque élément de classification du trafic dans le tableau spécifié par la structure NDIS_QOS_PARAMETERS. Cette structure est utilisée dans les requêtes OID suivantes :

Requêtes de requête OID de OID_QOS_OPERATIONAL_PARAMETERS et de OID_QOS_REMOTE_PARAMETERS.
Demandes de méthode OID de OID_QOS_PARAMETERS.

Le pilote miniport retourne également une structure NDIS_QOS_PARAMETERS qui contient un tableau de structures NDIS_QOS_CLASSIFICATION_ELEMENT dans les indications d’état NDIS suivantes :

Pour plus d’informations, consultez classifications de trafic NDIS QoS.

instructions pour définir les membres ConditionSelector et ConditionField

Le tableau suivant définit la plage de valeurs des membres ConditionSelector et ConditionField.

Valeur ConditionSelector	Valeur ConditionField
NDIS_QOS_CONDITION_RESERVED	Le membre ConditionField doit avoir la valeur zéro. Remarque Cette condition est réservée à une utilisation ultérieure.
NDIS_QOS_CONDITION_DEFAULT	Le membre ConditionField doit avoir la valeur zéro.
NDIS_QOS_CONDITION_TCP_PORT	Le membre ConditionField contient une valeur de port TCP de destination 16 bits.
NDIS_QOS_CONDITION_UDP_PORT	Le membre ConditionField contient une valeur de port UDP de destination 16 bits.
NDIS_QOS_CONDITION_TCP_OR_UDP_PORT	Le membre ConditionField contient une valeur de port TCP ou UDP de destination 16 bits.
NDIS_QOS_CONDITION_ETHERTYPE	Le membre ConditionField contient une valeur EtherType IEEE 16 bits. Remarque La carte réseau doit déterminer la disposition de trame du paquet afin d’inspecter l’EtherType. Par exemple, l’emplacement du champ EtherType est différent entre une trame Ethernet II et 802.3.
NDIS_QOS_CONDITION_NETDIRECT_PORT	Le membre ConditionField contient une valeur de port NetworkDirect 16 bits.

Si le membre ConditionSelector contient une valeur de NDIS_QOS_CONDITION_DEFAULT, l’action de classification associée doit être appliquée à tous les paquets de sortie qui ne correspondent à aucune autre condition de classification. Lorsque le composant DCB émet une requête de méthode OID de OID_QOS_PARAMETERS, il peut définir l'ConditionSelector sur NDIS_QOS_CONDITION_DEFAULT dans la première structure de NDIS_QOS_CLASSIFICATION_ELEMENT dans le tableau NDIS_QOS_PARAMETERS.

Si le membre ConditionSelector contient une valeur de NDIS_QOS_CONDITION_NETDIRECT_PORT, le pilote miniport doit correspondre au membre ConditionField par rapport au port source ou de destination d’une connexion NetworkDirect. Si le pilote miniport accepte une connexion NetDirect, le pilote doit correspondre au membre ConditionField par rapport au port source d’un paquet qu’il envoie via cette connexion. Si le pilote miniport lance une connexion NetDirect, il doit correspondre au membre ConditionField par rapport au port de destination d’un paquet qu’il envoie via cette connexion.

Pour plus d’informations sur le composant DCB, consultez architecture NDIS QoS pour data Center Bridging.

instructions pour définir les membres ActionSelector et ActionField

Le tableau suivant définit la plage de valeurs des membres ActionSelector et ActionField.

Valeur ActionSelector	Valeur ActionField
NDIS_QOS_ACTION_PRIORITY	Le membre ActionField contient une valeur de niveau de priorité IEEE 802.1p 3 bits. Pour plus d’informations sur ces niveaux de priorité, consultez ieee 802.1p Priority Levels.

À compter de NDIS 6.30, les actions de classification du trafic définissent un niveau de priorité IEEE 802.1p auquel le paquet de sortie est affecté. Lorsque la carte réseau affecte un niveau de priorité à un paquet de sortie, elle applique également les paramètres de la classe de trafic NDIS QoS associée au niveau de priorité spécifié. Ces paramètres déterminent la façon dont la carte réseau transmet le paquet, et incluent l’allocation de bande passante et l’algorithme de sélection de transmission (TSA).

Pour plus d’informations sur les classes de trafic NDIS QoS, consultez classes de trafic NDIS QoS.