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

Статья
08/07/2023

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

Синтаксис

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Параметры

MaximumNumberOfEntries

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

InitialAllocation

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

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

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

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

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

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	midatlax.h (включая Midatlax.h)
IRQL	<= APC_LEVEL