estrutura NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY (ntddndis.h)

Artigo
02/26/2024

NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY não é usado no momento e foi atualizado para NDIS_QOS_SQ_ARRAY para NDIS 6.45 e posterior.

A estrutura de NDIS_QOS_SQ_ARRAY é usada para enumerar filas de agendador de QoS (Qualidade de Serviço) do NDIS (SQs) para parâmetros e estatísticas. Essa estrutura é retornada nas solicitações de consulta OID OID_QOS_OFFLOAD_ENUM_SQS e OID_QOS_OFFLOAD_SQ_STATS.

Para exibir a definição de cabeçalho para NDIS_QOS_SQ_ARRAY, consulte Comentários.

Sintaxe

#define NDIS_QOS_SQ_PARAMETERS_ARRAY_REVISION_1        1

#if (NDIS_SUPPORT_NDIS684)
#define NDIS_QOS_SQ_ARRAY_REVISION_1                   1
#endif // (NDIS_SUPPORT_NDIS684)

typedef struct _NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY {
    NDIS_OBJECT_HEADER                 Header;
    ULONG                              Flags;
    NDIS_QOS_SQ_TYPE                   SqType;
    NDIS_QOS_SQ_ID                     FirstSqId;
    ULONG                              MaxSqsToReturn;
#if (NDIS_SUPPORT_NDIS684)
    union {
        ULONG                          SqArrayOffset;
        ULONG                          SqParamsArrayOffset;
    };
    union {
        ULONG                          SqArrayNumElements;
        ULONG                          SqParamsArrayNumElements;
    };
    union {
        ULONG                          SqArrayElementSize;
        ULONG                          SqParamsArrayElementSize;
    };
#else
    ULONG                              SqParamsArrayOffset;
    ULONG                              SqParamsArrayNumElements;
    ULONG                              SqParamsArrayElementSize;
#endif // (NDIS_SUPPORT_NDIS684)
} NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY, *PNDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY;

#if (NDIS_SUPPORT_NDIS684)
typedef struct _NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY NDIS_QOS_SQ_ARRAY, *PNDIS_QOS_SQ_ARRAY;
#define NDIS_SIZEOF_QOS_SQ_ARRAY_REVISION_1                     \
    RTL_SIZEOF_THROUGH_FIELD(NDIS_QOS_SQ_ARRAY, SqArrayElementSize)
#endif // (NDIS_SUPPORT_NDIS684)

#define NDIS_SIZEOF_QOS_SQ_PARAMETERS_ENUM_ARRAY_REVISION_1     \
    RTL_SIZEOF_THROUGH_FIELD(NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY, SqParamsArrayElementSize)

Membros

Header

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

O driver de miniporte deve definir o membro Tipo de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision como NDIS_QOS_SQ_PARAMETERS_ARRAY_REVISION_1 e o membro Size como NDIS_SIZEOF_QOS_SQ_PARAMETERS_ARRAY_REVISION_1.

Flags

Não usado em NDIS_QOS_SQ_PARAMETERS_ARRAY_REVISION_1. O chamador define esse campo como zero.

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.

FirstSqId

Um NDIS_QOS_SQ_ID que especifica a primeira ID SQ dessa matriz.

MaxSqsToReturn

O número máximo de SQs contidos nessa matriz.

SqArrayOffset

O deslocamento de bytes do início dessa estrutura que marca o início de uma matriz. O tipo de cada elemento depende da solicitação OID:

OID	Tipo de elemento
OID_QOS_OFFLOAD_ENUM_SQS	NDIS_QOS_SQ_PARAMETERS
OID_QOS_OFFLOAD_SQ_STATS	NDIS_QOS_SQ_STATS

SqParamsArrayOffset

Esse campo não é usado em NDIS_QOS_SQ_ARRAY.

SqArrayNumElements

O número de elementos nessa matriz especificado por SQArrayOffset.

SqParamsArrayNumElements

Esse campo não é usado em NDIS_QOS_SQ_ARRAY.

SqArrayElementSize

O tamanho de cada elemento nesta matriz.

SqParamsArrayElementSize

Esse campo não é usado em NDIS_QOS_SQ_ARRAY.

Comentários

A estrutura NDIS_QOS_SQ_ARRAY é usada para enumerar SQs de QoS para parâmetros e estatísticas.

Syntax

typedef struct _NDIS_QOS_SQ_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_QOS_SQ_TYPE   SqType;
  NDIS_QOS_SQ_ID     FirstSqId;
  ULONG              MaxSqsToReturn;
  ULONG              SqArrayOffset;
  ULONG              SqArrayNumElements;
  ULONG              SqArrayElementSize;
} NDIS_QOS_SQ_ARRAY, *PNDIS_QOS_SQ_ARRAY;

As descrições de membro acima explicam como definir os campos de NDIS_QOS_SQ_ARRAY .

NDIS_QOS_SQ_ARRAY é retornado na solicitação de consulta OID OID_QOS_OFFLOAD_ENUM_SQS, que enumera os SQs criados em um comutador NIC

NDIS_QOS_SQ_ARRAY também é retornado na OID_QOS_OFFLOAD_SQ_STATS de solicitação de consulta OID, usada para obter uma lista de SQs atualmente presentes em um adaptador de miniporte e seus contadores de estatísticas.

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)