RxCreateMidAtlas 函数 (midatlax.h)

RxCreateMidAtlas 分配MID_ATLAS数据结构的新实例并初始化它。

语法

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

参数

MaximumNumberOfEntries

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

InitialAllocation

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

返回值

RxCreateMidAtlas 返回一个指针,用于在成功时分配和初始化MID_ATLAS数据结构,或者在失败时返回 NULL 指针。

言论

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

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

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

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

要求

要求 价值
目标平台 桌面
标头 midatlax.h (包括 Midatlax.h)
IRQL <= APC_LEVEL

另请参阅

RxAssociateContextWithMid

RxDestroyMidAtlas

RxMapAndDissociateMidFromContext

RxMapMidToContext

RxReassociateMid