Função RxCreateMidAtlas (midatlax.h)
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.
Valor de retorno
RxCreateMidAtlas retorna um ponteiro para estrutura de dados MID_ATLAS alocada e inicializada com êxito ou um ponteiro de NULL sobre falha.
Observações
O RDBSS define uma ID multiplex (MID), um valor de 16 bits, que pode ser usado tanto pelo cliente de rede (minidiretório) quanto 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 paged ao criar uma nova estrutura de dados MID_ATLAS.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | midatlax.h (inclua Midatlax.h) |
| IRQL | <= APC_LEVEL |