RxCreateMidAtlas 函式 (midatlax.h)

發行項
03/05/2024

RxCreateMidAtlas 會配置MID_ATLAS數據結構的新實例，並將其初始化。

語法

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

參數

MaximumNumberOfEntries

在 atlas 中允許的多重標識子數目上限 (MID) 。

InitialAllocation

最初配置的多任務識別碼數目。

傳回值

RxCreateMidAtlas 會傳回指標，以在成功時配置和初始化MID_ATLAS數據結構，或在失敗時傳回 NULL 指標。

備註

RDBSS 定義 MID (Multiplex ID) ，這是一個 16 位值，可供網路用戶端 (迷你重新導向器) 和伺服器區分任何連線上的同時作用中要求。

MID 必須有效率地能夠從 65,536 個值的可能組合中管理一些 MID 的唯一標記和識別 (通常為 50) 。為了確保適當的時間空間取捨，查閱會組織為三層階層。用來表示 MID 的 16 位會分成三個位欄位元元。最右邊欄位的長度 (最小顯著性 ) 取決於 atlas 中允許的 MID 數目上限。這個最大值是建立MID_ATLAS數據結構時傳遞至 RxCreateMidAtlas 的參數。其餘的長度會在接下來兩個字段之間平均分割。

例如，如果要在建立時配置最多 50 個 MID，則第一個字段的長度為 6 (64 ( 2 ** 6 ) 大於 50 ) 。其餘長度會分割成兩個 5 位的欄位。

RxCreateMidAtlas 會在建立新的MID_ATLAS數據結構時配置非分頁集區內存。