Função FsRtlInitializeLargeMcb (ntifs.h)

Artigo
02/26/2024

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 .