structure NDIS_QOS_CAPABILITIES (ntddndis.h)

Article
02/07/2025

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

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 d’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 révision de d’en-tête sur la valeur suivante :

NDIS_QOS_CAPABILITIES_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1.

Flags

Valeur de ULONG qui contient une ou d’indicateurs qui spécifient les fonctionnalités NDIS QoS 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 de sélection de transmission de priorité stricte (TSA). Pour plus d’informations sur cet algorithme, consultez 'algorithme de priorité stricte.

Remarque Afin d’être conforme à DCB, la carte réseau doit prendre en charge la priorité stricte 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 de la sécurité du contrôle d’accès multimédia (MACsec). 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 qui datent avant le protocole IEEE 802.1Qaz Data Center Bridging Exchange (DCBX). Ces protocoles incluent la suite de protocoles Ethernet convergé (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 aux paramètres DCB d’être échangés entre deux homologues directement connectés. Cela permet à ces homologues d’adapter et de régler ces paramètres afin d’optimiser le transfert de données via la connexion. Pour plus d’informations sur ce protocole, consultez Vue d’ensemble desde pontage du centre de données.

Remarque Si cet indicateur est défini, le pilote miniport doit rejeter 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.

Remarque Pour que la carte réseau prend en charge NDIS QoS 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 ETS (Enhanced Transmission Selection).

Remarque Pour que la carte réseau prend en charge NDIS QoS pour DCB, elle doit prendre en charge au moins deux classes de trafic compatibles 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).

Remarque 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 NDIS QoS 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 NDIS QoS de la carte réseau.
Le pilote miniport initialise une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES avec les autres fonctionnalités matérielles assistées de la carte réseau. Le pilote définit le HardwareQosCapabilities membre 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.