NDIS_NIC_SWITCH_INFO_ARRAY结构(ntddndis.h)
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 将 标头 的 类型 成员设置为NDIS_OBJECT_TYPE_DEFAULT。 若要指定 NDIS_NIC_SWITCH_INFO_ARRAY 结构的版本,NDIS 将 Revision 成员 标头 设置为以下值:
NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1
NDIS 6.30 的原始版本。
将 大小 成员设置为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_REQUESTInformationBuffer 成员中 NDIS_NIC_SWITCH_INFO_ARRAY 结构的指针。
- 当 NDIS 调用 ProtocolBindAdapterEx 函数时,NDIS 会将指针传递给 BindParameters 参数中的 NDIS_BIND_PARAMETERS 结构。 NDIS 将 NicSwitchArrayNDIS_BIND_PARAMETERS 结构的成员设置为指向 NDIS_NIC_SWITCH_INFO_ARRAY 结构的指针。
- 当 NDIS 调用 FilterAttach 函数时,NDIS 将指针传递给 AttachParameters 参数中的 NDIS_FILTER_ATTACH_PARAMETERS 结构。 NDIS 将 NDIS_FILTER_ATTACH_PARAMETERS 结构的 NicSwitchArray 成员设置为指向 NDIS_NIC_SWITCH_INFO_ARRAY 结构的指针。
注释 从 NDIS 6.30 开始,只有描述默认网络适配器交换机信息的 NDIS_NIC_SWITCH_INFO 通过 OID 查询请求返回 OID_NIC_SWITCH_ENUM_SWITCHES。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDIS 6.30 及更高版本中受支持。 |
标头 | ntddndis.h (include Ndis.h) |
另请参阅