NDIS_QOS_CAPABILITIES structure (ntddndis.h)

Article
08/07/2023

La structure NDIS_QOS_CAPABILITIES spécifie les fonctionnalités de qualité de service (QoS) NDIS d’une carte réseau qui prend en charge l’interface IEEE 802.1 Data Center Bridging (DCB).

Syntaxe

typedef struct _NDIS_QOS_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              MaxNumTrafficClasses;
  ULONG              MaxNumEtsCapableTrafficClasses;
  ULONG              MaxNumPfcEnabledTrafficClasses;
} NDIS_QOS_CAPABILITIES, *PNDIS_QOS_CAPABILITIES;

Membres

Header

Type, révision et taille de la structure NDIS_QOS_CAPABILITIES . 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_CAPABILITIES. Pour spécifier la version de la structure NDIS_QOS_CAPABILITIES , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_QOS_CAPABILITIES_REVISION_1

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

Définissez le membre Taille sur NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs qui spécifient les fonctionnalités qoS NDIS prises en charge par une carte réseau. Les indicateurs suivants sont définis :

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

Si cet indicateur est défini, la carte réseau prend en charge l’algorithme TSA (Priority Transmission Selection Algorithm) strict. Pour plus d’informations sur cet algorithme, consultez Algorithme de priorité stricte.

Note Pour être conforme à DCB, la carte réseau doit prendre en charge la stricte priorité TSA.

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

Si cet indicateur est défini, la carte réseau prend en charge la possibilité de contourner le traitement MACsec (Media Access Control Security). Pour plus d’informations sur MACsec, reportez-vous à la norme 802.1AE-2006.

NDIS_QOS_CAPABILITIES_CEE_DCBX_SUPPORTED

Si cet indicateur est défini, la carte réseau et le pilote miniport prennent en charge les protocoles antérieurs au protocole IEEE 802.1Qaz Data Center Bridging Exchange (DCBX). Ces protocoles incluent la suite de protocoles Ethernet convergé amélioré (CEE).

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

Si cet indicateur est défini, la carte réseau et le pilote miniport prennent en charge le protocole IEEE 802.1Qaz DCBX. Le protocole DCBX permet d’échanger des paramètres DCB entre deux homologues directement connectés. Cela permet à ces homologues d’adapter et d’ajuster ces paramètres afin d’optimiser le transfert de données sur la connexion. Pour plus d’informations sur ce protocole, consultez Vue d’ensemble de Data Center Bridging.

Note Si cet indicateur est défini, le pilote miniport doit rejeter toutes les demandes d’envoi de paquets DCBX.

MaxNumTrafficClasses

Valeur ULONG qui spécifie le nombre maximal de classes de trafic NDIS QoS que la carte réseau prend en charge. Pour plus d’informations, consultez Classes de trafic NDIS QoS.

Note Pour que la carte réseau prend en charge la QoS NDIS pour DCB, elle doit prendre en charge au moins trois classes de trafic.

MaxNumEtsCapableTrafficClasses

Valeur ULONG qui spécifie le nombre maximal de classes de trafic QoS que la carte réseau peut utiliser avec l’algorithme ETS (Enhanced Transmission Selection). Cette valeur doit être inférieure ou égale à la valeur du membre MaxNumTrafficClasses .

Pour plus d’informations sur ETS, consultez Algorithme de sélection de transmission améliorée (ETS).

Note Pour que la carte réseau prend en charge la qoS NDIS pour DCB, elle doit prendre en charge au moins deux classes de trafic compatibles AVEC ETS.

MaxNumPfcEnabledTrafficClasses

Valeur ULONG qui spécifie le nombre maximal de classes de trafic QoS que la carte réseau peut utiliser avec l’algorithme PFC (Priority-based Flow Control). Cette valeur doit être inférieure ou égale à la valeur du membre MaxNumTrafficClasses .

Pour plus d’informations sur PFC, consultez Contrôle de flux basé sur la priorité (PFC).

Note Pour que la carte réseau prend en charge la QoS NDIS pour DCB, elle doit prendre en charge au moins une classe de trafic compatible PFC.

Remarques

Le pilote miniport inscrit les fonctionnalités De QoS NDIS de la carte réseau sous-jacente à partir de la fonction MiniportInitializeEx du pilote en procédant comme suit :

Le pilote miniport initialise une structure NDIS_QOS_CAPABILITIES avec les fonctionnalités qoS NDIS de la carte réseau.
Le pilote miniport initialise une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES avec les autres fonctionnalités assistées matérielles de la carte réseau. Le pilote définit le membre HardwareQosCapabilities de la structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES sur un pointeur vers la structure NDIS_QOS_CAPABILITIES .
Le pilote miniport appelle NdisMSetMiniportAttributes et définit le paramètre MiniportAttributes sur un pointeur vers la structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

La structure NDIS_QOS_CAPABILITIES est également retournée dans les requêtes de requête OID de OID_QOS_CURRENT_CAPABILITIES et de OID_QOS_HARDWARE_CAPABILITIES.