struttura NDIS_QOS_CAPABILITIES (ntddndis.h)

Articolo
02/07/2025

La struttura NDIS_QOS_CAPABILITIES specifica le funzionalità QoS (NDIS Quality of Service) di una scheda di rete che supporta l'interfaccia IEEE 802.1 Data Center Bridging (DCB).

Sintassi

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

Membri

Header

Tipo, revisione e dimensione della struttura NDIS_QOS_CAPABILITIES. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER.

Il driver miniport deve impostare il membro Type di Header su NDIS_OBJECT_TYPE_QOS_CAPABILITIES. Per specificare la versione della struttura di NDIS_QOS_CAPABILITIES, il driver deve impostare il membro revision di Header sul valore seguente:

NDIS_QOS_CAPABILITIES_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Dimensioni su NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1.

Flags

Valore di ULONG che contiene un OR bit per bit di flag che specificano le funzionalità QoS NDIS supportate da una scheda di rete. Sono definiti i flag seguenti:

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

Se questo flag è impostato, la scheda di rete supporta l'algoritmo TSA (Strict Priority Transmission Selection Algorithm). Per altre informazioni su questo algoritmo, vedere Strict Priority Algorithm.

Nota Per essere conforme a DCB, la scheda di rete deve supportare il TSA con priorità rigorosa.

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

Se questo flag è impostato, la scheda di rete supporta la possibilità di ignorare l'elaborazione del controllo di accesso multimediale (MACsec). Per altre informazioni su MACsec, vedere lo standard 802.1AE-2006.

NDIS_QOS_CAPABILITIES_CEE_DCBX_SUPPORTED

Se questo flag è impostato, la scheda di rete e il driver miniport supportano i protocolli pre-data del protocollo IEEE 802.1Qaz Data Center Bridging Exchange (DCBX). Questi protocolli includono la suite di protocolli Cee (Converged Enhanced Ethernet).

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

Se questo flag è impostato, la scheda di rete e il driver miniport supportano il protocollo IEEE 802.1Qaz DCBX. Il protocollo DCBX consente lo scambio di parametri DCB tra due peer connessi direttamente. In questo modo questi peer possono adattare e ottimizzare questi parametri per ottimizzare il trasferimento dei dati tramite la connessione. Per altre informazioni su questo protocollo, vedere Panoramica di Data Center Bridging.

Nota Se questo flag è impostato, il driver miniport deve rifiutare eventuali richieste di invio per i pacchetti DCBX.

MaxNumTrafficClasses

Valore di ULONG che specifica il numero massimo di classi di traffico QoS NDIS supportate dalla scheda di rete. Per altre informazioni, vedere classi di traffico QoS NDIS.

Nota Affinché la scheda di rete supporti QoS NDIS per DCB, deve supportare almeno tre classi di traffico.

MaxNumEtsCapableTrafficClasses

Valore ULONG che specifica il numero massimo di classi di traffico QoS che la scheda di rete può usare con l'algoritmo ETS (Enhanced Transmission Selection). Questo valore deve essere minore o uguale al valore del membro MaxNumTrafficClasses.

Per altre informazioni su ETS, vedere Enhanced Transmission Selection (ETS) Algorithm.

Nota Affinché la scheda di rete supporti QoS NDIS per DCB, deve supportare almeno due classi di traffico che supportano ETS.

MaxNumPfcEnabledTrafficClasses

Valore di ULONG che specifica il numero massimo di classi di traffico QoS che la scheda di rete può usare con l'algoritmo PFC (Priority-based Flow Control). Questo valore deve essere minore o uguale al valore del membro MaxNumTrafficClasses.

Per altre informazioni su PFC, vedere PFC (Priority-based Flow Control).

Nota Affinché la scheda di rete supporti QoS NDIS per DCB, deve supportare almeno una classe di traffico con supporto PFC.

Osservazioni

Il driver miniport registra le funzionalità QoS NDIS della scheda di rete sottostante dalla funzione MiniportInitializeEx del driver seguendo questa procedura:

Il driver miniport inizializza una struttura NDIS_QOS_CAPABILITIES con le funzionalità QoS NDIS della scheda di rete.
Il driver miniport inizializza una struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES con le altre funzionalità supportate dall'hardware della scheda di rete. Il driver imposta il HardwareQosCapabilities membro della struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES su un puntatore alla struttura NDIS_QOS_CAPABILITIES.
Il driver miniport chiama NdisMSetMiniportAttributes e imposta il parametro MiniportAttributes su un puntatore alla struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

La struttura NDIS_QOS_CAPABILITIES viene restituita anche nelle richieste di query OID di OID_QOS_CURRENT_CAPABILITIES e OID_QOS_HARDWARE_CAPABILITIES.