Función FsRtlLookupLargeMcbEntry (ntifs.h)

2025-02-07

Dado un número de bloque virtual (VBN) y un bloque de control de mapa (MCB), el FsRtlLookupLargeMcbEntry rutina 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 el MCB, FALSE de lo contrario.

Observaciones

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

Si existe dicha asignación, la operación de búsqueda produce valores positivos para el recuento de lbN y sector 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 todavía 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.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL