Função RxCreateMidAtlas (midatlax.h)

Artigo
03/05/2024

RxCreateMidAtlas aloca uma nova instância de MID_ATLAS estrutura de dados e a inicializa.

Sintaxe

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Parâmetros

MaximumNumberOfEntries

O número máximo de IDs multiplex (MIDs) a serem permitidas no atlas.

InitialAllocation

O número de IDs multiplex alocadas inicialmente.

Retornar valor

RxCreateMidAtlas retorna um ponteiro para a estrutura de dados alocada e inicializada MID_ATLAS com êxito ou um ponteiro NULL sobre falha.

Comentários

O RDBSS define uma ID multiplex (MID), um valor de 16 bits, que pode ser usado pelo cliente de rede (minidiretório) e pelo servidor para distinguir entre as solicitações simultâneas ativas em qualquer conexão.

O MID deve ser capaz de gerenciar com eficiência a marcação exclusiva e a identificação de vários MIDs (normalmente 50) de uma combinação possível de 65.536 valores. Para garantir uma compensação de espaço no tempo adequada, a pesquisa é organizada como uma hierarquia de três níveis. Os 16 bits usados para representar um MID são divididos em três campos de bits. O comprimento do campo mais à direita (menos significativo ) é decidido pelo número máximo de MIDs que devem ser permitidos no atlas. Esse valor máximo é um parâmetro passado para RxCreateMidAtlas quando a estrutura de dados MID_ATLAS é criada. O comprimento restante é dividido igualmente entre os próximos dois campos.

Por exemplo, se um máximo de 50 MIDs devem ser alocados na criação , o comprimento do primeiro campo é 6 (64 ( 2 ** 6 ) é maior que 50 ). O comprimento restante é dividido em dois campos de 5 bits cada.

RxCreateMidAtlas aloca memória de pool não paginada ao criar uma nova estrutura de dados MID_ATLAS.