Función FsRtlInitializeLargeMcb (ntifs.h)

Artículo
02/27/2024

La rutina FsRtlInitializeLargeMcb inicializa una estructura de bloque de control de mapa (MCB).

Sintaxis

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

Parámetros

Mcb

Puntero a una estructura MCB asignada por el autor de la llamada que se va a inicializar.

[in] PoolType

Tipo de grupo que se va a usar al asignar almacenamiento interno adicional para el MCB. Uno de los siguientes:

NonPagedPool
PagedPool
NonPagedPoolCacheAligned
PagedPoolCacheAligned

Los tipos de grupo NonPagedPoolMustSucceed y NonPagedPoolCacheAlignedMustS están obsoletos y ya no deben usarse.

Valor devuelto

None

Observaciones

FsRtlInitializeLargeMcb inicializa una estructura de bloque de control de mapa (MCB). Los sistemas de archivos usan estructuras MCB para asignar números de bloque virtual (VBN) para un archivo a los números de bloque lógicos (LBN) correspondientes en el disco.

Se omiten los 32 bits superiores del LBN. Solo se usan los 32 bits inferiores.

Los sistemas de archivos deben llamar a FsRtlInitializeLargeMcb antes de usar cualquier otra rutina FsRtlXxxMcbYyy en la estructura MCB.

Si se produce un error de asignación de grupo, FsRtlInitializeLargeMcb genera una excepción de STATUS_INSUFFICIENT_RESOURCES. Para obtener control si se produce este error de asignación de grupo, el controlador debe encapsular la llamada a FsRtlInitializeLargeMcb en una instrucción try-except o try-finally .