NDIS_SWITCH_NIC_ARRAY结构（ntddndis.h）

项目
02/07/2025

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 结构。

标头的类型成员必须设置为NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_NIC_ARRAY 结构的版本，必须将标头的 Revision 成员设置为以下值：

NDIS_SWITCH_NIC_ARRAY_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将大小成员设置为NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1。

Flags

包含标志的按位或的 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 结构。