Funzione FsRtlInitializeLargeMcb (ntifs.h)

Articolo
02/26/2024

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 per l'allocazione di risorse di archiviazione interne aggiuntive per mcB. I tipi validi sono:

NonPagedPool
PagedPool
NonPagedPoolCacheAligned
PagedPoolCacheAligned

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.

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 routine FsRtlXxxMcbYyy nella 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.