estrutura NDIS_QOS_SQ_PARAMETERS (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_QOS_SQ_PARAMETERS contém os parâmetros de uma Fila do Agendador de Qualidade de Serviço (QoS) do NDIS (SQ).

Sintaxe

typedef struct _NDIS_QOS_SQ_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_QOS_SQ_ID     SqId;
  NDIS_QOS_SQ_TYPE   SqType;
  BOOLEAN            TcEnabledTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              TcTransmitBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              TcTransmitBandwidthReservationTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              TcReceiveBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              CrossTcTransmitBandwidthCap;
  ULONG              MaxNumSqInputs;
} NDIS_QOS_SQ_PARAMETERS, *PNDIS_QOS_SQ_PARAMETERS;

Membros

Header

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

O driver de miniporte deve definir o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision como NDIS_QOS_SQ_PARAMETERS_REVISION_2 e o membro Size como NDIS_SIZEOF_QOS_SQ_PARAMETERS_REVISION_2.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esses sinalizadores especificam os diversos recursos e atributos dos recursos de descarregamento de QoS de hardware que estão habilitados no SQ. Os seguintes sinalizadores são definidos:

NDIS_QOS_SQ_TRANSMIT_CAP_ENABLED

Se esse sinalizador estiver definido, as tampas de largura de banda de transmissão serão habilitadas neste SQ.

NDIS_QOS_SQ_TRANSMIT_RESERVATION_ENABLED

Se esse sinalizador estiver definido, as reservas de largura de banda de transmissão serão habilitadas neste SQ.

NDIS_QOS_SQ_RECEIVE_CAP_ENABLED

Se esse sinalizador estiver definido, as tampas de largura de banda de recebimento serão habilitadas neste SQ.

SqId

Um NDIS_QOS_SQ_ID que contém a ID SQ deste SQ. O NDIS atribui essa ID.

SqType

Um NDIS_QOS_SQ_TYPE que contém o tipo desse SQ. Isso pode ser NdisQSQosSqSqSQTypeStandard da definição de enumeração de NDIS_QOS_SQ_TYPE.

TcEnabledTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Uma matriz de valores BOOLEAN que especificam se cada classe de tráfego (de 0 a NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES) está habilitada para agendamento neste SQ.

Qualquer classe de tráfego (TC) para a qual esse campo é TRUE deve ser lido e validado nas tabelas abaixo e também é limitado por CrossTcTransmitBandwidthCap.

Qualquer TC para o qual esse campo é FALSE não participa da limitação de taxa de QoS de CrossTcTransmitBandwidthCap ou das tabelas por TC abaixo.

TcTransmitBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Uma matriz de elementos ULONG que especificam tampas de largura de banda de transmissão para cada TC, em Mbps. Os elementos só serão válidos se o NDIS_QOS_SQ_TRANSMIT_CAP_ENABLED sinalizador estiver definido e seu elemento correspondente em TcEnabledTable for TRUE. Um elemento com um valor igual a 0 não tem limite.

A NIC deverá enfileirar todos os pacotes de transmissão neste SQ para um determinado TC se eles excederem a taxa especificada nesta tabela.

TcTransmitBandwidthReservationTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Uma matriz de elementos ULONG que especificam reservas de largura de banda de transmissão para cada TC, em valores relativos de 0 – ULONG_MAX. Os elementos só serão válidos se o NDIS_QOS_SQ_TRANSMIT_RESERVATION_ENABLED sinalizador estiver definido e seu elemento correspondente em TcEnabledTable for TRUE. Um elemento com um valor de 0 significa que os pacotes de transmissão nesse SQ/TC compartilham a reserva padrão do SQ para esse TC.

A NIC deverá enfileirar todos os pacotes de transmissão neste SQ para um determinado TC se outros SQs exigirem largura de banda para atender à reserva para esse TC.

TcReceiveBandwidthCapTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Uma matriz de elementos ULONG que especificam o recebimento de tampas de largura de banda para cada TC, em Mbps. Os elementos só serão válidos se o NDIS_QOS_SQ_RECEIVE_CAP_ENABLED sinalizador estiver definido e seu elemento correspondente em TcEnabledTable for TRUE. Um elemento com um valor igual a 0 não tem limite.

Esse é um recurso opcional para habilitar o capping de largura de banda de recebimento. As NICs que anunciam o suporte ao limite de recebimento devem descartar qualquer pacote de recebimento depois que um determinado TC neste SQ excedeu a taxa especificada nessa matriz (com base na implementação de agendamento da NIC).

CrossTcTransmitBandwidthCap

Um valor ULONG que especifica a tampa de largura de banda de transmissão para o tráfego entre TCs cujo elemento correspondente em TcEnabledTable será TRUE, se o NDIS_QOS_SQ_TRANSMIT_CAP_ENABLED sinalizador estiver definido.

MaxNumSqInputs

Um valor ULONG que oferece uma "dica" para o miniporto no número provável de vPorts que o sistema operacional associará ao SQ. Esse valor não pode ser modificado após a criação do SQ.

O miniporto pode usar essa dica para gerenciar melhor seus recursos. O miniporto fornecerá um serviço de melhor esforço para atender à solicitação, mas pode falhar devido a recursos insuficientes no momento da criação do SQ ou no tempo de associação do vPort.

O miniporto deverá retornar um erro se esse valor exceder o valor MaxNumSQInputs especificado pelo miniporto em NDIS_QOS_OFFLOAD_CAPABILITIES.

Comentários

A estrutura NDIS_QOS_SQ_PARAMETERS é retornada na OID_QOS_OFFLOAD_ENUM_SQS de solicitação de consulta OID, que enumera SQs criados em um comutador NIC.

NDIS_QOS_SQ_PARAMETERS também é retornado no OID_QOS_OFFLOAD_CREATE_SQ de solicitação do método OID, que cria um novo SQ no adaptador de miniporte.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.85 e posterior.
Servidor mínimo com suporte	Windows Server 2022
Cabeçalho	ntddndis.h (inclua ndis.h)