FsRtlInitializeLargeMcb, fonction (ntifs.h)
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 pour initialiser.
[in] PoolType
Type de pool à utiliser lors de l’allocation d’un stockage interne supplémentaire pour le MCB. L’une des opérations suivantes :
- NonPagedPool
- pagedPool
- nonPagedPoolCacheAligned
- PagedPoolCacheAligned
Les types de pool NonPagedPoolMustSucceed et NonPagedPoolCacheAlignedMustS pool sont obsolètes et ne doivent plus être utilisés.
Valeur de retour
Aucun
Remarques
FsRtlInitializeLargeMcb initialise une structure de bloc de contrôle de carte (MCB). Les systèmes de fichiers utilisent des structures MCB pour mapper des numéros de bloc virtuel (VBN) pour un fichier aux numéros de bloc logiques correspondants (LBN) 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 déclenche 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |