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

Статья
09/27/2023

При наличии номера виртуального блока (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.

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

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

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL