NDIS_QOS_CAPABILITIES estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_QOS_CAPABILITIES especifica os recursos de QoS (Qualidade de Serviço) do NDIS de um adaptador de rede que dá suporte à interface DCB (Ponte de Data Center) do IEEE 802.1.

Sintaxe

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

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_QOS_CAPABILITIES. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER.

O driver de miniporto deve definir o Type membro do de cabeçalho para NDIS_OBJECT_TYPE_QOS_CAPABILITIES. Para especificar a versão da estrutura de NDIS_QOS_CAPABILITIES, o driver deve definir o membro de Revisão do de Cabeçalho para o seguinte valor:

NDIS_QOS_CAPABILITIES_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho do como NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1.

Flags

Um valor ULONG que contém um or bit a bit de sinalizadores que especificam os recursos de QoS do NDIS compatíveis com um adaptador de rede. Os seguintes sinalizadores são definidos:

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

Se esse sinalizador estiver definido, o adaptador de rede oferecerá suporte ao algoritmo de seleção de transmissão de prioridade estrita (TSA). Para obter mais informações sobre esse algoritmo, consulte de algoritmo de prioridade estrita.

Observação Para estar em conformidade com o DCB, o adaptador de rede deve dar suporte à TSA de prioridade estrita.

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

Se esse sinalizador estiver definido, o adaptador de rede oferecerá suporte à capacidade de ignorar o processamento de MACsec (segurança de controle de acesso de mídia). Para obter mais informações sobre o MACsec, consulte o padrão 802.1AE-2006.

NDIS_QOS_CAPABILITIES_CEE_DCBX_SUPPORTED

Se esse sinalizador estiver definido, o adaptador de rede e o driver de miniporto darão suporte aos protocolos que datam previamente o protocolo DCBX (Data Center Bridging Exchange) do IEEE 802.1Qaz. Esses protocolos incluem o conjunto de protocolos CEE (Converged Enhanced Ethernet).

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

Se esse sinalizador estiver definido, o adaptador de rede e o driver de miniporto darão suporte ao protocolo DCBX IEEE 802.1Qaz. O protocolo DCBX permite que os parâmetros do DCB sejam trocados entre dois pares diretamente conectados. Isso permite que esses pares adaptem e ajustem esses parâmetros para otimizar a transferência de dados pela conexão. Para obter mais informações sobre esse protocolo, consulte Visão geral dode ponte do Data Center.

Observação Se esse sinalizador estiver definido, o driver de miniporto deverá rejeitar quaisquer solicitações de envio para pacotes DCBX.

MaxNumTrafficClasses

Um ULONG valor que especifica o número máximo de classes de tráfego QoS de NDIS compatíveis com o adaptador de rede. Para obter mais informações, consulte NDIS QoS Traffic Classes.

Observação Para que o adaptador de rede dê suporte ao NDIS QoS para DCB, ele deve dar suporte a pelo menos três classes de tráfego.

MaxNumEtsCapableTrafficClasses

Um valor ULONG que especifica o número máximo de classes de tráfego QoS que o adaptador de rede pode usar com o algoritmo ETS (Seleção de Transmissão Avançada). Esse valor deve ser menor ou igual ao valor do membro MaxNumTrafficClasses.

Para obter mais informações sobre ETS, consulte algoritmo ETS (Seleção de Transmissão Avançada).

Observação Para que o adaptador de rede dê suporte ao NDIS QoS para DCB, ele deve dar suporte a pelo menos duas classes de tráfego compatíveis com ETS.

MaxNumPfcEnabledTrafficClasses

Um ULONG valor que especifica o número máximo de classes de tráfego QoS que o adaptador de rede pode usar com o algoritmo PFC (Controle de Fluxo baseado em prioridade). Esse valor deve ser menor ou igual ao valor do membro MaxNumTrafficClasses.

Para obter mais informações sobre o PFC, consulte PFC (Controle de Fluxo Baseado em Prioridade).

Observação Para que o adaptador de rede dê suporte ao NDIS QoS para DCB, ele deve dar suporte a pelo menos uma classe de tráfego compatível com PFC.

Observações

O driver de miniporto registra as funcionalidades de QoS do NDIS do adaptador de rede subjacente da função MiniportInitializeEx do driver seguindo estas etapas:

O driver de miniporto inicializa uma estrutura de NDIS_QOS_CAPABILITIES com os recursos de QoS do NDIS do adaptador de rede.
O driver de miniporto inicializa uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES com os outros recursos assistidos por hardware do adaptador de rede. O driver define o HardwareQosCapabilities membro da estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES como um ponteiro para a estrutura NDIS_QOS_CAPABILITIES.
O driver de miniporto chama NdisMSetMiniportAttributes e define o parâmetro MiniportAttributes como um ponteiro para a estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

A estrutura de NDIS_QOS_CAPABILITIES também é retornada em solicitações de consulta OID de OID_QOS_CURRENT_CAPABILITIES e OID_QOS_HARDWARE_CAPABILITIES.