Fonction RxCreateMidAtlas (midatlax.h)

Article
02/29/2024

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 retournée

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

Remarques

RDBSS définit un ID multiplex (MID), une valeur 16 bits, qui peut être utilisé à la fois par le client réseau (mini-redirecteur) et le serveur pour faire la distinction entre les demandes 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. Afin de garantir un compromis d’espace temps approprié, la recherche est organisée sous la forme d’une hiérarchie à 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éterminée 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 manière é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 de 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.