NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY 結構 (ntddndis.h)

發行項
02/26/2024

NDIS_QOS_SQ_PARAMETERS_ENUM_ARRAY 目前未使用，且已更新為 NDIS 6.45 和更新版本的 NDIS_QOS_SQ_ARRAY 。

NDIS_QOS_SQ_ARRAY結構可用來列舉參數和統計數據 (SQs) 的 NDIS 服務品質 (QoS) 排程器佇列。此結構會在 OID 查詢要求中傳回OID_QOS_OFFLOAD_ENUM_SQS和OID_QOS_OFFLOAD_SQ_STATS。

若要檢視NDIS_QOS_SQ_ARRAY的標頭定義，請參閱。

語法

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

成員

Header

NDIS_QOS_SQ_STATS 結構的型別、修訂和大小。這個成員會格式化為 NDIS_OBJECT_HEADER 結構。

迷你埠驅動程序必須將 Header 的 Type 成員設定為 [NDIS_OBJECT_TYPE_DEFAULT]、將 [修訂成員] 設定為 [NDIS_QOS_SQ_PARAMETERS_ARRAY_REVISION_1]，並將 [大小] 成員設定為 [NDIS_SIZEOF_QOS_SQ_PARAMETERS_ARRAY_REVISION_1]。

Flags

未用於NDIS_QOS_SQ_PARAMETERS_ARRAY_REVISION_1。呼叫端會將此欄位設定為零。

SqType

包含此 SQ 類型的 NDIS_QOS_SQ_TYPE 。這可以是 NdisQSQSQSqSQTypeStandard ，來自 NDIS_QOS_SQ_TYPE的列舉定義。

FirstSqId

指定此陣列第一個 SQ 識別碼的NDIS_QOS_SQ_ID。

MaxSqsToReturn

此陣列中包含的 SQ 數目上限。

SqArrayOffset

這個結構開頭的位元組移，這個結構會標記數位的開頭。每個元素的類型取決於 OID 要求：

OID	項目類型
OID_QOS_OFFLOAD_ENUM_SQS	NDIS_QOS_SQ_PARAMETERS
OID_QOS_OFFLOAD_SQ_STATS	NDIS_QOS_SQ_STATS

SqParamsArrayOffset

此欄位不會用於 NDIS_QOS_SQ_ARRAY。

SqArrayNumElements

SQArrayOffset 所指定此陣列中的項目數目。

SqParamsArrayNumElements

此欄位不會用於 NDIS_QOS_SQ_ARRAY。

SqArrayElementSize

這個陣列中每個元素的大小。

SqParamsArrayElementSize

此欄位不會用於 NDIS_QOS_SQ_ARRAY。

備註

NDIS_QOS_SQ_ARRAY 結構可用來列舉參數和統計數據的 QoS SQs。

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;

上述成員描述說明如何設定 NDIS_QOS_SQ_ARRAY 欄位。

NDIS_QOS_SQ_ARRAY 會在 OID 查詢要求 OID_QOS_OFFLOAD_ENUM_SQS中傳回，它會列舉在 NIC 交換器上建立的 SQ

NDIS_QOS_SQ_ARRAY 也會在 OID 查詢要求 OID_QOS_OFFLOAD_SQ_STATS中傳回，用來取得目前出現在迷你埠配接器及其統計數據計數器上的 SQ 清單。