Функция RxCreateMidAtlas (midatlax.h)

Статья
02/07/2025

RxCreateMidAtlas выделяет новый экземпляр структуры данных MID_ATLAS и инициализирует его.

Синтаксис

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Параметры

MaximumNumberOfEntries

Максимальное число мультиплексных идентификаторов (MID), разрешенных в атласе.

InitialAllocation

Число идентификаторов мультиплекса, выделенных изначально.

Возвращаемое значение

RxCreateMidAtlas возвращает указатель на выделенную и инициализированную структуру данных MID_ATLAS по успешному выполнению или null указателю на сбой.

Замечания

RDBSS определяет мультиплексный идентификатор (MID), 16-разрядное значение, которое можно использовать как сетевым клиентом (мини-перенаправлением), так и сервером, чтобы различать одновременные активные запросы для любого подключения.

Mid должен эффективно управлять уникальными тегами и идентификацией ряда MID (обычно 50) из возможного сочетания 655 536 значений. Чтобы обеспечить правильный компромисс пространства времени, подстановка организована как трехуровневая иерархия. 16 битов, используемых для представления MID, разделены на три бита. Длина самого правого поля (наименее значимая) определяется максимальным числом MID, которые должны быть разрешены в атласе. Это максимальное значение — это параметр, передаваемый RxCreateMidAtlas при создании структуры данных MID_ATLAS. Оставшаяся длина разделена одинаково между следующими двумя полями.

Например, если при создании должно быть выделено не более 50 MID, длина первого поля составляет 6 (64 (2 ** 6) больше 50). Оставшаяся длина разделена на два поля из 5 битов.

RxCreateMidAtlas выделяет нестраничную память пула при создании новой структуры данных MID_ATLAS.