RxCreateMidAtlas 函数 (midatlax.h)

项目
02/26/2024

RxCreateMidAtlas 分配MID_ATLAS数据结构的新实例并对其进行初始化。

语法

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

参数

MaximumNumberOfEntries

在地图集中允许) 多路复用 ID (MID 的最大数目。

InitialAllocation

最初分配的多路复用 ID 数。

返回值

RxCreateMidAtlas 在成功时返回指向已分配和初始化MID_ATLAS数据结构的指针，或在失败时返回 NULL 指针。

注解

RDBSS 定义多路复用 ID (MID) （一个 16 位值），网络客户端 (微型重定向程序) 和服务器都可以使用该 ID 来区分任何连接上的并发活动请求。

MID 必须能够有效地管理多个 MID 的唯一标记和标识， (通常从 65,536 个值的可能组合中管理 50) 。为了确保适当的时空权衡，查找组织为三级层次结构。用于表示 MID 的 16 位拆分为三个位域。最右侧字段 (最小有效 ) 的长度由地图集中允许的最大 MID 数决定。此最大值是在创建MID_ATLAS数据结构时传递给 RxCreateMidAtlas 的参数 。剩余长度在接下来的两个字段之间平均拆分。

例如，如果在创建时最多分配 50 个 MID，则第一个字段的长度为 6 (64 ( 2 ** 6 ) 大于 50 ) 。剩余长度拆分为两个字段，每个字段 5 位。

RxCreateMidAtlas 在创建新的MID_ATLAS数据结构时分配非分页池内存。