NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY-Struktur (ntddndis.h)

Artikel
02/29/2024

NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY wird derzeit nicht verwendet und wurde auf NDIS_QOS_SQ_ARRAY für NDIS 6.45 und höher aktualisiert.

Die NDIS_QOS_SQ_ARRAY-Struktur wird verwendet, um NDIS Quality of Service (QoS) Scheduler Queues (SQs) für Parameter und Statistiken aufzulisten. Diese Struktur wird in den OID-Abfrageanforderungen OID_QOS_OFFLOAD_ENUM_SQS und OID_QOS_OFFLOAD_SQ_STATS zurückgegeben.

Informationen zum Anzeigen der Headerdefinition für NDIS_QOS_SQ_ARRAY finden Sie unter Hinweise.

Syntax

#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)

Member

Header

Typ, Revision und Größe der NDIS_QOS_SQ_STATS-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT, der Revisionsmember auf NDIS_QOS_SQ_PARAMETERS_ARRAY_REVISION_1 und das Element Größe auf NDIS_SIZEOF_QOS_SQ_PARAMETERS_ARRAY_REVISION_1 festlegen.

Flags

In NDIS_QOS_SQ_PARAMETERS_ARRAY_REVISION_1 nicht verwendet. Der Aufrufer legt dieses Feld auf 0 (null) fest.

SqType

Eine NDIS_QOS_SQ_TYPE , die den Typ dieses SQ enthält. Dies kann NdisQSQosSqSQTypeStandard aus der Enumerationsdefinition von NDIS_QOS_SQ_TYPE sein.

FirstSqId

Eine NDIS_QOS_SQ_ID, die die erste SQ-ID dieses Arrays angibt.

MaxSqsToReturn

Die maximale Anzahl von SQs, die in diesem Array enthalten sind.

SqArrayOffset

Der Byteoffset vom Anfang dieser Struktur, der den Anfang eines Arrays markiert. Der Typ der einzelnen Elemente hängt von der OID-Anforderung ab:

OID	Elementtyp
OID_QOS_OFFLOAD_ENUM_SQS	NDIS_QOS_SQ_PARAMETERS
OID_QOS_OFFLOAD_SQ_STATS	NDIS_QOS_SQ_STATS

SqParamsArrayOffset

Dieses Feld wird in NDIS_QOS_SQ_ARRAY nicht verwendet.

SqArrayNumElements

Die Anzahl der Elemente in diesem Array, die von SQArrayOffset angegeben wird.

SqParamsArrayNumElements

Dieses Feld wird in NDIS_QOS_SQ_ARRAY nicht verwendet.

SqArrayElementSize

Die Größe der einzelnen Elemente in diesem Array.

SqParamsArrayElementSize

Dieses Feld wird in NDIS_QOS_SQ_ARRAY nicht verwendet.

Hinweise

Die NDIS_QOS_SQ_ARRAY-Struktur wird verwendet, um QoS-SQs für Parameter und Statistiken aufzulisten.

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;

In den obigen Memberbeschreibungen wird erläutert, wie die NDIS_QOS_SQ_ARRAY Felder festgelegt werden.

NDIS_QOS_SQ_ARRAY wird in der OID-Abfrageanforderung OID_QOS_OFFLOAD_ENUM_SQS zurückgegeben, die die auf einem NIC-Switch erstellten SQs aufzählt.

NDIS_QOS_SQ_ARRAY wird auch in der OID-Abfrageanforderung OID_QOS_OFFLOAD_SQ_STATS zurückgegeben, die verwendet wird, um eine Liste der derzeit auf einem Miniportadapter vorhandenen SQs und deren Stat-Indikatoren abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.85 und höher.
Unterstützte Mindestversion (Server)	Windows Server 2022
Kopfzeile	ntddndis.h (include ndis.h)