Função FsRtlInitializeLargeMcb (ntifs.h)
A rotina FsRtlInitializeLargeMcb inicializa uma estrutura de MCB (bloco de controle de mapa).
Sintaxe
void FsRtlInitializeLargeMcb(
PLARGE_MCB Mcb,
[in] POOL_TYPE PoolType
);
Parâmetros
Mcb
Ponteiro para uma estrutura MCB alocada pelo chamador para inicializar.
[in] PoolType
Tipo de pool a ser usado ao alocar armazenamento interno adicional para o MCB. Um dos seguintes:
- NonPagedPool
- PagedPool
- NonPagedPoolCacheAligned
- PagedPoolCacheAligned
Os tipos de pool NonPagedPoolMustSucceed e NonPagedPoolCacheAlignedMustS estão obsoletos e não devem mais ser usados.
Retornar valor
Nenhum
Comentários
FsRtlInitializeLargeMcb inicializa uma estrutura de MCB (bloco de controle de mapa). Os sistemas de arquivos usam estruturas MCB para mapear números de bloco virtual (VBN) para um arquivo para os LBN (números de bloco lógico) correspondentes no disco.
Os 32 bits superiores do LBN são ignorados. Somente os 32 bits inferiores são usados.
Os sistemas de arquivos devem chamar FsRtlInitializeLargeMcb antes de usar qualquer outra rotina FsRtlXxxMcbYyy na estrutura MCB.
Se ocorrer uma falha de alocação de pool, FsRtlInitializeLargeMcb gerará uma exceção STATUS_INSUFFICIENT_RESOURCES. Para obter controle se essa falha de alocação de pool ocorrer, o driver deverá encapsular a chamada para FsRtlInitializeLargeMcb em uma instrução try-except ou try-finally .
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Universal |
Cabeçalho | ntifs.h (inclua Ntifs.h) |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |