NDIS_NDK_CONNECTIONS 结构 (ntddndis.h)
NDIS_NDK_CONNECTIONS 结构描述微型端口适配器上处于活动状态的 NDK 连接。
语法
typedef struct _NDIS_NDK_CONNECTIONS {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
ULONG Count;
BOOLEAN NDConnectionsMappedtoTCPConnections;
NDIS_NDK_CONNECTION_ENTRY Connections[1];
} NDIS_NDK_CONNECTIONS;
成员
Header
描述此 NDIS_NDK_CONNECTIONS 结构的 NDIS_OBJECT_HEADER 结构。 按如下所示设置 NDIS_OBJECT_HEADER 结构的成员:
- 将 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT。
- 将 Revision 成员设置为 NDIS_NDK_CONNECTIONS_REVISION_1。
- 将 Size 成员设置为 (USHORT) min (MAXUSHORT,NDIS_SIZEOF_NDK_CONNECTIONS_REVISION_1 (n) ) 。
Flags
Count
在Connections成员中传递的连接数组中的元素数。 数组中的每个元素都是 NDIS_NDK_CONNECTION_ENTRY 结构。
NDConnectionsMappedtoTCPConnections
一个 BOOLEAN 值,该值指定如何映射连接。 如果 NDK 提供程序的 RDMA 技术要求提供程序将 ND 连接映射到 TCP 连接,则 NDK 提供程序必须将 NDConnectionsMappedtoTCPConnections 成员设置为 TRUE。 否则, NDConnectionsMappedtoTCPConnections 为 FALSE。
Connections[1]
NDIS_NDK_CONNECTION_ENTRY 结构的可变大小数组,其中数组的大小由返回的连接数决定。 Count 成员指定连接数组中的元素数。
注解
NDIS_NDK_CONNECTIONS 结构随 OID_NDK_CONNECTIONS OID 一起返回。 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向此结构的指针。
此结构大小可变,包含与返回的连接数相等的元素。 作为元素计数的连接数组的实际大小由 Count 成员指示。
如果 NDK 提供程序的 RDMA 技术要求提供程序将 ND 连接映射到 TCP 连接,则 NDK 提供程序还必须报告每个 ND 连接的基础 TCP 连接 4 元组,如下所示:
- 将 NDConnectionsMappedtoTCPConnections 成员设置为 TRUE。
- 对每个 ND 连接使用两个连续条目。 第一个条目包含本地和远程 IP 地址 (ND 寻址信息,ND 端口号) 紧接着的条目包含相应的 TCP 连接的寻址信息 (本地和远程 IP 地址,以及 TCP 端口号) 。
- 除寻址信息以外的成员 (例如, UserModeOwner 和 OwnerPid) 必须仅在第一个条目中设置,而在下一个条目中保持不变。 因此,索引 0、2、4 等的条目包含 ND 寻址信息 (加上正确填充的其他成员) ,索引 1、3、5 等,包含 TCP 寻址信息 (,其中其他成员) 保持不变。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 不支持,在 NDIS 6.30 及更高版本中受支持。 |
最低受支持的服务器 | Windows Server 2012 |
标头 | ntddndis.h (包括 Ndis.h) |