Функция MmFlushImageSection (ntifs.h)
MmFlushImageSection подпрограмма очищает раздел изображения для файла.
Синтаксис
BOOLEAN MmFlushImageSection(
PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] MMFLUSH_TYPE FlushType
);
Параметры
SectionObjectPointer
Указатель на структуру, содержащую указатели объекта раздела файла.
[in] FlushType
Указывает причину операции очистки. Это может быть одно из значений, перечисленных в следующей таблице.
| Значение FlushType | Значение |
|---|---|
| MmFlushForDelete | Файл удаляется. |
| MmFlushForWrite | Файл открывается для доступа к записи. |
Возвращаемое значение
MmFlushImageSection возвращает значение TRUE, если операция очистки выполнена успешно, или если для файла нет раздела изображения; в противном случае MmFlushImageSection возвращает FALSE.
Замечания
Файловая система должна вызывать подпрограмму mmFlushImageSection перед удалением файла или открытием файла для доступа на запись.
Перед удалением файла файловая система должна вызывать MmFlushImageSection из его IRP_MJ_SET_INFORMATION или IRP_MJ_CLEANUP подпрограммы отправки, передав MmFlushForDelete для параметра FlushType.
При открытии файла для доступа на запись файловая система должна вызывать MmFlushImageSection из подпрограммы отправки IRP_MJ_CREATE, передав MmFlushForWrite для параметра FlushType.
Если сопоставленные представления раздела изображения отсутствуют, MmFlushImageSection уничтожает раздел изображения и возвращает все используемые страницы в бесплатный список.
Прежде чем использовать MmFlushImageSection, записи файловой системы настоятельно рекомендуется изучить способ использования этой процедуры в примере FASTFAT.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (include Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |