Funzione RxCreateMidAtlas (midatlax.h)

Articolo
02/29/2024

RxCreateMidAtlas alloca una nuova istanza di MID_ATLAS struttura dei dati e la inizializza.

Sintassi

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Parametri

MaximumNumberOfEntries

Numero massimo di ID multiplex (MID) da consentire nell'atlas.

InitialAllocation

Numero di ID multiplex allocati inizialmente.

Valore restituito

RxCreateMidAtlas restituisce un puntatore allocato e inizializzato MID_ATLAS struttura di dati in caso di esito positivo o di un puntatore NULL in caso di errore.

Commenti

RDBSS definisce un ID multiplex (MID), un valore a 16 bit, che può essere usato sia dal client di rete (mini-redirector) che dal server per distinguere tra le richieste simultanee attive in qualsiasi connessione.

MID deve essere in grado di gestire in modo efficiente l'assegnazione di tag univoci e l'identificazione di un numero di MID (in genere 50) da una combinazione possibile di 65.536 valori. Per garantire un compromesso dello spazio temporale appropriato, la ricerca è organizzata come gerarchia a tre livelli. I 16 bit usati per rappresentare un mid sono suddivisi in tre campi di bit. La lunghezza del campo più a destra (meno significativa ) è decisa dal numero massimo di ID che devono essere consentiti nell'atlas. Questo valore massimo è un parametro passato a RxCreateMidAtlas quando viene creata la struttura di dati MID_ATLAS. La lunghezza rimanente viene suddivisa equamente tra i due campi successivi.

Ad esempio, se un massimo di 50 MID deve essere allocato per la creazione , la lunghezza del primo campo è 6 (64 ( 2 ** 6 ) è maggiore di 50 ). La lunghezza rimanente è suddivisa in due campi di 5 bit ciascuno.

RxCreateMidAtlas alloca memoria del pool non a pagina quando si crea una nuova struttura di dati MID_ATLAS.