Función FsRtlGetNextLargeMcbEntry (ntifs.h)

  • Artículo

La rutina FsRtlGetNextLargeMcbEntry recupera una ejecución de asignación de un bloque de control de mapa (MCB).

Sintaxis

BOOLEAN FsRtlGetNextLargeMcbEntry(
       PLARGE_MCB Mcb,
  [in] ULONG      RunIndex,
       PLONGLONG  Vbn,
       PLONGLONG  Lbn,
       PLONGLONG  SectorCount
);

Parámetros

Mcb

Puntero a una estructura MCB inicializada.

[in] RunIndex

Índice de base cero de la ejecución de asignación solicitada.

Vbn

Puntero a una variable que recibe el número de bloque virtual (VBN) inicial de la ejecución de asignación o cero si la ejecución no existe. Su valor no tiene sentido si FsRtlGetNextLargeMcbEntry devuelve FALSE.

Lbn

Puntero a una variable que recibe el número de bloque lógico (LBN) inicial de la ejecución de asignación, o cero si la ejecución no existe. Su valor no tiene sentido si FsRtlGetNextLargeMcbEntry devuelve FALSE.

SectorCount

Puntero a una variable que recibe el número de sectores de la ejecución de asignación o cero si la ejecución no existe. Su valor no tiene sentido si FsRtlGetNextLargeMcbEntry devuelve FALSE.

Valor devuelto

FsRtlGetNextLargeMcbEntry devuelve TRUE si la ejecución de asignación solicitada existe en el MCB, FALSE en caso contrario.

Comentarios

FsRtlGetNextLargeMcbEntry recupera el VBN inicial, el lbn inicial y el recuento de sectores para una ejecución de asignación en un MCB.

Nota Se omiten los 32 bits superiores del LBN. Solo se usan los 32 bits inferiores.
 
Los agujeros se cuentan como ejecuciones.

El fragmento de código siguiente muestra cómo imprimir todas las ejecuciones en un archivo:

for (i = 0; FsRtlGetNextLargeMcbEntry(Mcb,i,&Vbn,&Lbn,&Count); i++) {

    // print out vbn, lbn, and count

}

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

FsRtlAddLargeMcbEntry

FsRtlInitializeLargeMcb

FsRtlLookupLargeMcbEntry

FsRtlLookupLastLargeMcbEntry

FsRtlLookupLastLargeMcbEntryAndIndex

FsRtlNumberOfRunsInLargeMcb

FsRtlRemoveLargeMcbEntry

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb