Função FsRtlInitializeLargeMcb (ntifs.h)

A rotina FsRtlInitializeLargeMcb inicializa uma estrutura 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 por 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
Nota Os tipos de pool NonPagedPoolMustSucceed e NonPagedPoolCacheAlignedMustS estão obsoletos e não devem mais ser usados.
 

Valor retornado

Nenhum

Comentários

FsRtlInitializeLargeMcb inicializa uma estrutura mcb (bloco de controle de mapa). Os sistemas de arquivos usam estruturas MCB para mapear números de blocos virtuais (VBN) para um arquivo para os números de bloco lógico correspondentes (LBN) no disco.

Nota 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 outro FsRtl... Mcb... rotinas 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

   
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

FsRtlAddLargeMcbEntry

FsRtlGetNextLargeMcbEntry

FsRtlLookupLargeMcbEntry

FsRtlLookupLastLargeMcbEntry

FsRtlLookupLastLargeMcbEntryAndIndex

FsRtlNumberOfRunsInLargeMcb

FsRtlRemoveLargeMcbEntry

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb