Función RxCreateMidAtlas (midatlax.h)

Artículo
03/05/2024

RxCreateMidAtlas asigna una nueva instancia de MID_ATLAS estructura de datos y la inicializa.

Sintaxis

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Parámetros

MaximumNumberOfEntries

Número máximo de identificadores multiplex (MID) que se permitirán en el atlas.

InitialAllocation

Número de identificadores multiplex asignados inicialmente.

Valor devuelto

RxCreateMidAtlas devuelve un puntero a la estructura de datos asignada e inicializada MID_ATLAS si se ejecuta correctamente o un puntero NULL en caso de error.

Comentarios

RDBSS define un id. de multiplex (MID), un valor de 16 bits, que puede usar el cliente de red (minidirector) y el servidor para distinguir entre las solicitudes activas simultáneamente en cualquier conexión.

Mid debe ser eficazmente capaz de administrar el etiquetado único y la identificación de un número de MID (normalmente 50) a partir de una posible combinación de 65 536 valores. Para garantizar un equilibrio de espacio de tiempo adecuado, la búsqueda se organiza como una jerarquía de tres niveles. Los 16 bits usados para representar un MID se dividen en tres campos de bits. La longitud del campo más a la derecha (menos significativa) se decide por el número máximo de MID que se van a permitir en el atlas. Este valor máximo es un parámetro pasado a RxCreateMidAtlas cuando se crea la estructura de datos MID_ATLAS. La longitud restante se divide igualmente entre los dos campos siguientes.

Por ejemplo, si se va a asignar un máximo de 50 MID al crear , la longitud del primer campo es 6 (64 ( 2 ** 6 ) es mayor que 50 ). La longitud restante se divide en dos campos de 5 bits cada uno.

RxCreateMidAtlas asigna memoria de grupo no paginada al crear una nueva estructura de datos MID_ATLAS.