NDIS_SWITCH_PORT_ARRAY 结构 (ntddndis.h)

项目
08/07/2023

NDIS_SWITCH_PORT_ARRAY 结构指定端口配置参数的数组。数组中的每个元素指定 Hyper-V 可扩展交换机端口的参数。每个元素的格式设置为 NDIS_SWITCH_PORT_PARAMETERS 结构。

语法

typedef struct _NDIS_SWITCH_PORT_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_PORT_ARRAY, *PNDIS_SWITCH_PORT_ARRAY;

成员

Header

NDIS_SWITCH_PORT_ARRAY 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

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

NDIS_SWITCH_PORT_ARRAY_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PORT_ARRAY_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。此成员是为 NDIS 保留的。

FirstElementOffset

一个 USHORT 值，该值指定此结构后面的元素数组中第一个元素的偏移量（以字节为单位）。偏移量从 NDIS_SWITCH_PORT_ARRAY 结构的开头到第一个元素的开头。数组中的每个元素都是一个NDIS_SWITCH_PORT_PARAMETERS 结构。

注意如果 NumElements 设置为零，则忽略此成员。

NumElements

一个 ULONG 值，该值指定遵循NDIS_SWITCH_PORT_ARRAY结构NDIS_SWITCH_PORT_PARAMETERS元素的数目。

ElementSize

一个 ULONG 值，该值指定NDIS_SWITCH_PORT_ARRAY结构后面的 NDIS_SWITCH_PORT_PARAMETERS 元素的大小（以字节为单位）。

注解

NDIS_SWITCH_PORT_ARRAY 结构在 OID_SWITCH_PORT_ARRAY 的 OID 查询请求中返回。 NDIS_SWITCH_PORT_PARAMETERS 结构的数组遵循与这些 OID 查询请求关联的信息缓冲区中的 NDIS_SWITCH_PORT_ARRAY 结构。 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向此信息缓冲区的指针。

可扩展交换机扩展可以使用 NDIS_SWITCH_PORT_AT_ARRAY_INDEX 宏访问 NDIS_SWITCH_PORT_ARRAY 结构中的单个 NDIS_SWITCH_PORT_PARAMETERS 元素。