NDIS_NIC_SWITCH_INFO_ARRAY 结构 (ntddndis.h)

项目
02/29/2024

NDIS_NIC_SWITCH_INFO_ARRAY 结构指定数组。数组中的每个元素指定在网络适配器上创建的网络适配器交换机的属性。

语法

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

成员

Header

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

NDIS 将 Header 的 Type 成员设置为NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_NIC_SWITCH_INFO_ARRAY结构的版本，NDIS 将 Header 的 Revision 成员设置为以下值：

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

NDIS 6.30 的原始版本。

将 Size 成员设置为NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1。

FirstElementOffset

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

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

NumElements

一个 ULONG 值，该值指定 NDIS_NIC_SWITCH_INFO_ARRAY 结构后面的元素数。

ElementSize

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

注解

NDIS 通过以下方式返回 NDIS_NIC_SWITCH_INFO_ARRAY 结构：

当 NDIS 处理 OID_NIC_SWITCH_ENUM_SWITCHES 的 OID 查询请求时，它将返回指向NDIS_OID_REQUEST的 InformationBuffer 成员中的NDIS_NIC_SWITCH_INFO_ARRAY结构的指针。
当 NDIS 调用 ProtocolBindAdapterEx 函数时，NDIS 会在 BindParameters 参数中传递指向 NDIS_BIND_PARAMETERS 结构的指针。 NDIS 将 NDIS_BIND_PARAMETERS 结构的 NicSwitchArray 成员设置为指向NDIS_NIC_SWITCH_INFO_ARRAY结构的指针。
当 NDIS 调用 FilterAttach 函数时，NDIS 将指针传递到 AttachParameters 参数中的 NDIS_FILTER_ATTACH_PARAMETERS 结构。 NDIS 将 NDIS_FILTER_ATTACH_PARAMETERS 结构的 NicSwitchArray 成员设置为指向NDIS_NIC_SWITCH_INFO_ARRAY结构的指针。