NDIS_QOS_CAPABILITIES struttura (ntddndis.h)

Articolo
08/07/2023

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;

Members

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 Intestazione su NDIS_OBJECT_TYPE_QOS_CAPABILITIES. Per specificare la versione della struttura NDIS_QOS_CAPABILITIES , il driver deve impostare il membro Revisionedell'intestazione sul valore seguente:

NDIS_QOS_CAPABILITIES_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1.

Flags

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

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

Se questo flag è impostato, la scheda di rete supporta l'algoritmo di selezione della trasmissione con priorità rigorosa (TSA). Per altre informazioni su questo algoritmo, vedere Algoritmo con priorità rigorosa.

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

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

Se questo flag è impostato, la scheda di rete supporta la possibilità di ignorare l'elaborazione maCsec (Media Access Control Security). 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 supporta i protocolli che pre-date il protocollo IEEE 802.1Qaz Data Center Bridging Exchange (DCBX). Questi protocolli includono la suite di protocolli Ethernet avanzato (CEE) convergente.

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

Se questo flag è impostato, la scheda di rete e il driver miniport supporta il protocollo IEEE 802.1Qaz DCBX. Il protocollo DCBX consente lo scambio di parametri DCB tra due peer connessi direttamente. Ciò consente a questi peer di adattare e ottimizzare questi parametri per ottimizzare il trasferimento dei dati sulla 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 pacchetti DCBX.

MaxNumTrafficClasses

Valore 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 QoS di 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 Algoritmo ETS (Enhanced Transmission Selection).

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

MaxNumPfcEnabledTrafficClasses

Valore 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 Controllo del flusso basato su priorità (PFC).

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

Commenti

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 membro HardwareQosCapabilities 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.