Функция FsRtlGetNextLargeMcbEntry (ntifs.h)

Статья
12/21/2024

Подпрограмма FsRtlGetNextLargeMcbEntry извлекает выполнение сопоставления из блока управления картой (MCB).

Синтаксис

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

Параметры

Mcb

Указатель на инициализированную структуру MCB.

[in] RunIndex

Отсчитываемый от нуля индекс запрошенного выполнения сопоставления.

Vbn

Указатель на переменную, которая получает начальный номер виртуального блока (VBN) выполнения сопоставления или ноль, если выполнение не существует. Его значение бессмысленно, если FsRtlGetNextLargeMcbEntry возвращает FALSE.

Lbn

Указатель на переменную, которая получает начальный номер логического блока (LBN) выполнения сопоставления или ноль, если выполнение не существует. Его значение бессмысленно, если FsRtlGetNextLargeMcbEntry возвращает FALSE.

SectorCount

Указатель на переменную, которая получает количество секторов в выполнении сопоставления или ноль, если выполнение не существует. Его значение бессмысленно, если FsRtlGetNextLargeMcbEntry возвращает FALSE.

Возвращаемое значение

FsRtlGetNextLargeMcbEntry возвращает TRUE, если запрошенное выполнение сопоставления существует в MCB, FALSE в противном случае.

Замечания

FsRtlGetNextLargeMcbEntry извлекает начальный VBN, начиная с LBN и число секторов для выполнения сопоставления в MCB.

Примечание Верхние 32 бита LBN игнорируются. Используются только более низкие 32 бита.

Отверстия считаются запусками.

В следующем фрагменте кода показано, как распечатать все запуски в файле:

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

    // print out vbn, lbn, and count

}

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL