Función FsRtlInitializeLargeMcb (ntifs.h)

Artículo
12/21/2024

El FsRtlInitializeLargeMcb rutina 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 nonPagedPoolMustSucceed y NonPagedPoolCacheAlignedMustS tipos de grupo están obsoletos y ya no se deben usar.

Valor devuelto

Ninguno

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 FsRtlXxxMcbYyyy rutinas 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 un try-except o instrucción try-finally.