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

Статья
02/07/2025

Учитывая номер виртуального блока (VBN) и блок управления картой (MCB), FsRtlLookupLargeMcbEntry подпрограмма выполняет поиск mcB для сопоставления сведений, соответствующих указанному VBN.

Синтаксис

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

Параметры

Mcb

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

Vbn

Указатель на запрошенный VBN.

Lbn

Указатель на переменную, которая получает LBN, сопоставленную с largeVbn в записи сопоставления, или -1, если такой LBN не существует. Этот параметр является необязательным и может иметь значение NULL.

SectorCountFromLbn

Указатель на переменную, которая получает количество секторов, которые следуют за LargeVbn в выполнении сопоставления. Этот параметр является необязательным и может иметь значение NULL.

StartingLbn

Указатель на переменную, которая получает LBN, соответствующую началу выполнения сопоставления, или -1, если такой LBN не существует. Этот параметр является необязательным и может иметь значение NULL.

SectorCountFromStartingLbn

Указатель на переменную, которая получает количество секторов в выполнении сопоставления. Этот параметр является необязательным и может иметь значение NULL.

[out, optional] Index

Указатель на переменную, которая получает индекс выполнения сопоставления, содержащего VBN. Этот параметр является необязательным и может иметь значение NULL.

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

FsRtlLookupLargeMcbEntry возвращает значение TRUE, если указанный VBN находится в диапазоне виртуальных сетей, сопоставленных MCB, false в противном случае.

Замечания

FsRtlLookupLargeMcbEntry ищет запись сопоставления в MCB, запуск которой включает указанный VBN.

Если такое сопоставление существует, операция подстановки дает положительные значения для соответствующего числа LBN и сектора, а FsRtlLookupLargeMcbEntry возвращает ЗНАЧЕНИЕ TRUE.
Если такое сопоставление не существует, но указанный VBN меньше, чем самый высокий VBN, сопоставленный MCB, это называется отверстием в сопоставлении. В этом случае FsRtlLookupLargeMcbEntry по-прежнему возвращает значение TRUE, но операция подстановки дает значение -1 для LBN.
Если указанный VBN выше, чем самый высокий VBN, сопоставленный MCB, или если MCB не содержит сопоставлений, FsRtlLookupLargeMcbEntry возвращает значение FALSE.

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

Требования

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