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

Статья
02/29/2024

Подпрограмма FsRtlResetLargeMcb усекает структуру блока управления картой (MCB), чтобы она содержала ноль пар сопоставления. Массив пар сопоставления не сжимается.

Синтаксис

void FsRtlResetLargeMcb(
  [in] PLARGE_MCB Mcb,
  [in] BOOLEAN    SelfSynchronized
);

Параметры

[in] Mcb

Указатель на структуру MCB для усечения.

[in] SelfSynchronized

Указывает, синхронизирован ли вызывающий объект по отношению к MCB.

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

None

Remarks

FsRtlResetLargeMcb усекает структуру блока управления картой (MCB). Файловые системы используют структуры MCB для сопоставления номеров виртуальных блоков (VBN) для файла с соответствующими номерами логических блоков (LBN) на диске.

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

Файловые системы должны вызывать FsRtlInitializeLargeMcb перед использованием любого другого FsRtl... Mcb... подпрограммы в структуре MCB.

Если вызывающий объект уже синхронизирован (параметр SelfSynchronized имеет значение TRUE), поэтому ни один другой поток операции не может вызывать подпрограмму Mcb для этого mcb во время этого вызова, то FsRtlResetLargeMcb просто очищает текущее число пар сопоставления. Если параметр SelfSynchronized имеет значение FALSE, то FsRtlResetLargeMcb сериализует доступ к Mcb , прежде чем очищать количество пар, что требует больше времени.

Требования

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