NDIS_SWITCH_NIC_ARRAY 結構 (ntddndis.h)

發行項
03/05/2024

NDIS_SWITCH_NIC_ARRAY 結構會指定網路適配器組態參數的數位。陣列中的每個元素都會指定連接到 Hyper-V 可延伸交換器上埠之網路適配器的參數。每個元素都會格式化為 NDIS_SWITCH_NIC_PARAMETERS 結構。

語法

typedef struct _NDIS_SWITCH_NIC_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_NIC_ARRAY, *PNDIS_SWITCH_NIC_ARRAY;

成員

Header

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

Header 的 Type 成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_SWITCH_NIC_ARRAY結構的版本，標頭的 Revision 成員必須設定為下列值：

NDIS_SWITCH_NIC_ARRAY_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1。

Flags

包含旗標位 OR 的 ULONG 值。此成員保留給 NDIS。

FirstElementOffset

USHORT 值，指定此結構後面元素陣列中第一個元素的位移，以位元組為單位。位移是從 NDIS_SWITCH_NIC_ARRAY 結構的開頭到第一個專案的開頭來測量。陣列中的每個專案都是 NDIS_SWITCH_NIC_PARAMETERS 結構。

注意如果 NumElements 設定為零，則會忽略此成員。

NumElements

ULONG 值，指定NDIS_SWITCH_NIC_ARRAY結構後面的NDIS_SWITCH_NIC_PARAMETERS元素數目。

ElementSize

ULONG 值，指定NDIS_SWITCH_NIC_ARRAY結構後面NDIS_SWITCH_NIC_PARAMETERS元素的大小，以位元組為單位。

備註

NDIS_SWITCH_NIC_ARRAY結構會在 OID_SWITCH_NIC_ARRAY 的 OID 查詢要求中傳回。 NDIS_SWITCH_NIC_PARAMETERS 結構的陣列會遵循與 OID 查詢要求相關聯之資訊緩衝區中的NDIS_SWITCH_NIC_ARRAY結構。 NDIS_OID_REQUEST 結構的 InformationBuffer 成員包含此資訊緩衝區的指標。

可延伸交換器延伸模組可以使用 NDIS_SWITCH_NIC_AT_ARRAY_INDEX 宏，存取NDIS_SWITCH_NIC_ARRAY結構內的個別 NDIS_SWITCH_NIC_PARAMETERS結構。