RxCreateMidAtlas, fonction (midatlax.h)

Article
02/07/2025

RxCreateMidAtlas alloue une nouvelle instance de MID_ATLAS structure de données et l’initialise.

Syntaxe

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Paramètres

MaximumNumberOfEntries

Nombre maximal d’ID multiplex (MID) à autoriser dans l’atlas.

InitialAllocation

Nombre d’ID multiplex alloués initialement.

Valeur de retour

RxCreateMidAtlas retourne un pointeur vers une structure de données MID_ATLAS allouée et initialisée en cas de réussite ou d’un pointeur NULL NULL en cas d’échec.

Remarques

RDBSS définit un ID multiplex (MID), une valeur 16 bits qui peut être utilisée par le client réseau (mini-redirecteur) et le serveur pour faire la distinction entre les requêtes actives simultanées sur n’importe quelle connexion.

Le MID doit être en mesure de gérer efficacement l’étiquetage et l’identification uniques d’un certain nombre de MID (généralement 50) à partir d’une combinaison possible de 65 536 valeurs. Pour garantir un compromis d’espace temps approprié, la recherche est organisée sous la forme d’une hiérarchie de trois niveaux. Les 16 bits utilisés pour représenter un MID sont divisés en trois champs de bits. La longueur du champ le plus à droite (le moins significatif) est décidé par le nombre maximal de MID qui doivent être autorisés dans l’atlas. Cette valeur maximale est un paramètre passé à RxCreateMidAtlas lors de la création de la structure de données MID_ATLAS. La longueur restante est répartie de façon égale entre les deux champs suivants.

Par exemple, si un maximum de 50 MID doivent être alloués lors de la création, la longueur du premier champ est 6 (64 ( 2 ** 6 ) est supérieure à 50 ). La longueur restante est divisée en deux champs de 5 bits chacun.

RxCreateMidAtlas alloue de la mémoire de pool non paginée lors de la création d’une structure de données MID_ATLAS.