Funzione FsRtlInitializeLargeMcb (ntifs.h)

La routine FsRtlInitializeLargeMcb inizializza una struttura MCB (Map Control Block).

Sintassi

void FsRtlInitializeLargeMcb(
       PLARGE_MCB Mcb,
  [in] POOL_TYPE  PoolType
);

Parametri

Mcb

Puntatore a una struttura MCB allocata dal chiamante per inizializzare.

[in] PoolType

Tipo di pool da usare durante l'allocazione di un'archiviazione interna aggiuntiva per mcB. I tipi validi sono:

  • NonPagedPool
  • PagedPool
  • NonPagedPoolCacheAligned
  • PagedPoolCacheAligned
Nota I tipi di pool NonPagedPoolMustSucceed e NonPagedPoolCacheAlignedMustS sono obsoleti e non devono più essere usati.
 

Valore restituito

nessuno

Osservazioni

FsRtlInitializeLargeMcb inizializza una struttura MCB (Map Control Block). I file system usano strutture MCB per eseguire il mapping dei numeri di blocco virtuale (VBN) per un file ai numeri di blocco logici corrispondenti (LBN) sul disco.

Nota I 32 bit superiori del LBN vengono ignorati. Vengono usati solo i 32 bit inferiori.
 
I file system devono chiamare FsRtlInitializeLargeMcb prima di usare qualsiasi altra fsRtl... Mcb... routine sulla struttura MCB.

Se si verifica un errore di allocazione del pool, FsRtlInitializeLargeMcb genera un'eccezione STATUS_INSUFFICIENT_RESOURCES. Per ottenere il controllo se si verifica questo errore di allocazione del pool, il driver deve eseguire il wrapping della chiamata a FsRtlInitializeLargeMcb in un'istruzione try-except o try-finally.

Requisiti

   
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Vedi anche

FsRtlAddLargeMcbEntry

FsRtlGetNextLargeMcbEntry

FsRtlLookupLargeMcbEntry

FsRtlLookupLastLargeMcbEntry

FsRtlLookupLastLargeMcbEntryAndIndex

FsRtlNumberOfRunsInLargeMcb

FsRtlRemoveLargeMcbEntry

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb