Fonction FsRtlInitializeLargeMcb (ntifs.h)

Article
02/29/2024

La routine FsRtlInitializeLargeMcb initialise une structure de bloc de contrôle de carte (MCB).

Syntaxe

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

Paramètres

Mcb

Pointeur vers une structure MCB allouée par l’appelant à initialiser.

[in] PoolType

Type de pool à utiliser lors de l’allocation d’un stockage interne supplémentaire pour le mcb. Celui-ci peut avoir l'une des valeurs suivantes :

NonPagedPool
PagedPool
NonPagedPoolCacheAligned
PagedPoolCacheAligned

Les types de pool NonPagedPoolMustSucceed et NonPagedPoolCacheAlignedMustS sont obsolètes et ne doivent plus être utilisés.

Valeur de retour

None

Remarques

FsRtlInitializeLargeMcb initialise une structure de bloc de contrôle de carte (MCB). Les systèmes de fichiers utilisent des structures MCB pour mapper les numéros de blocs virtuels (VBN) d’un fichier aux numéros de blocs logiques (LBN) correspondants sur le disque.

Les 32 bits supérieurs du LBN sont ignorés. Seuls les 32 bits inférieurs sont utilisés.

Les systèmes de fichiers doivent appeler FsRtlInitializeLargeMcb avant d’utiliser d’autres routines FsRtlXxxMcbYyy sur la structure MCB.

Si un échec d’allocation de pool se produit, FsRtlInitializeLargeMcb lève une exception STATUS_INSUFFICIENT_RESOURCES. Pour contrôler si cet échec d’allocation de pool se produit, le pilote doit encapsuler l’appel à FsRtlInitializeLargeMcb dans une instruction try-except ou try-finally .