Función FsRtlLookupLargeMcbEntry (ntifs.h)

Artículo
03/05/2024

Dado un número de bloque virtual (VBN) y un bloque de control de mapa (MCB), la rutina FsRtlLookupLargeMcbEntry busca en el MCB información de asignación correspondiente al VBN especificado.

Sintaxis

BOOLEAN FsRtlLookupLargeMcbEntry(
                  PLARGE_MCB Mcb,
                  LONGLONG   Vbn,
                  PLONGLONG  Lbn,
                  PLONGLONG  SectorCountFromLbn,
                  PLONGLONG  StartingLbn,
                  PLONGLONG  SectorCountFromStartingLbn,
  [out, optional] PULONG     Index
);

Parámetros

Mcb

Puntero a una estructura MCB inicializada.

Vbn

Puntero al VBN solicitado.

Lbn

Puntero a una variable que recibe el LBN asignado a LargeVbn en la entrada de asignación, o -1 si no existe dicho LBN. Este parámetro es opcional y puede ser NULL.

SectorCountFromLbn

Puntero a una variable que recibe el número de sectores que siguen a LargeVbn en la ejecución de asignación. Este parámetro es opcional y puede ser NULL.

StartingLbn

Puntero a una variable que recibe el LBN correspondiente al inicio de la ejecución de asignación, o -1 si no existe dicho LBN. Este parámetro es opcional y puede ser NULL.

SectorCountFromStartingLbn

Puntero a una variable que recibe el número de sectores de la ejecución de asignación. Este parámetro es opcional y puede ser NULL.

[out, optional] Index

Puntero a una variable que recibe el índice de la ejecución de asignación que contiene el VBN. Este parámetro es opcional y puede ser NULL.

Valor devuelto

FsRtlLookupLargeMcbEntry devuelve TRUE si el VBN especificado está dentro del intervalo de VBN asignados por MCB, FALSE de lo contrario.

Comentarios

FsRtlLookupLargeMcbEntry busca una entrada de asignación en el MCB cuya ejecución incluye el VBN especificado.

Si existe una asignación de este tipo, la operación de búsqueda produce valores positivos para el lbN y el recuento de sectores correspondientes, y FsRtlLookupLargeMcbEntry devuelve TRUE.
Si no existe dicha asignación, pero el VBN especificado es menor que el VBN más alto asignado por el MCB, esto se conoce como un agujero en la asignación. En este caso, FsRtlLookupLargeMcbEntry sigue devuelve TRUE, pero la operación de búsqueda produce un valor de -1 para el LBN.
Si el VBN especificado es mayor que el VBN más alto asignado por el MCB, o si el MCB no contiene ninguna asignación, FsRtlLookupLargeMcbEntry devuelve FALSE.

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