NDIS_SWITCH_NIC_ARRAY 结构 (ntddndis.h)

项目
02/26/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 结构的版本，必须将 Header 的 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 结构。