RxCreateMidAtlas, fonction (midatlax.h)

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 pour allouer et initialiser MID_ATLAS structure de données sur la 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é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 le balisage 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 en tant que 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 transmis à RxCreateMidAtlas lorsque la structure de données MID_ATLAS est créée. 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 6 (64 ( 2 ** 6 ) est supérieure à 50 ). La longueur restante est divisée en deux champs de 5 bits chacun.

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

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête midatlax.h (include Midatlax.h)
IRQL <= APC_LEVEL

Voir aussi

RxAssociateContextWithMid

RxDestroyMidAtlas

RxMapAndDissociateMidFromContext

RxMapMidToContext

RxReassociateMid