estrutura NDIS_QOS_CAPABILITIES (ntddndis.h)

Artigo
08/07/2023

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 miniporta deve definir o membro Type de Header como NDIS_OBJECT_TYPE_QOS_CAPABILITIES. Para especificar a versão da estrutura NDIS_QOS_CAPABILITIES , o driver deve definir o membro Revision de Header com o seguinte valor:

NDIS_QOS_CAPABILITIES_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size 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 for definido, o adaptador de rede oferecerá suporte ao TSA (algoritmo de seleção de transmissão de prioridade estrita). Para obter mais informações sobre esse algoritmo, consulte Algoritmo de prioridade estrita.

Nota 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 for definido, o adaptador de rede oferecerá suporte à capacidade de ignorar o processamento de MACsec (segurança de controle de acesso à 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 for definido, o adaptador de rede e o driver de miniporta 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 miniporta darão suporte ao protocolo DCBX IEEE 802.1Qaz. O protocolo DCBX permite que os parâmetros dcb sejam trocados entre dois pares conectados diretamente. 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 da ponte do Data Center.

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

MaxNumTrafficClasses

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

Nota Para que o adaptador de rede dê suporte a QoS NDIS 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 de 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).

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

MaxNumPfcEnabledTrafficClasses

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 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 pfc, consulte Controle de fluxo baseado em prioridade (PFC).

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

Comentários

O driver de miniporta registra os recursos de QoS do NDIS do adaptador de rede subjacente da função MiniportInitializeEx do driver seguindo estas etapas:

O driver de miniporta inicializa uma estrutura NDIS_QOS_CAPABILITIES com as funcionalidades de QoS do NDIS do adaptador de rede.
O driver de miniporta inicializa uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES com os outros recursos assistidos por hardware do adaptador de rede. O driver define o membro HardwareQosCapabilities 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 NDIS_QOS_CAPABILITIES também é retornada em solicitações de consulta OID de OID_QOS_CURRENT_CAPABILITIES e OID_QOS_HARDWARE_CAPABILITIES.