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

Статья
08/07/2023

Подпрограмма FsRtlLogCcFlushError регистрирует ошибку потерянной задержки записи и отображает диалоговое окно для пользователя.

Синтаксис

NTSTATUS FsRtlLogCcFlushError(
  [in] PUNICODE_STRING          FileName,
  [in] PDEVICE_OBJECT           DeviceObject,
  [in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in] NTSTATUS                 FlushError,
  [in] ULONG                    Flags
);

Параметры

[in] FileName

Имя файла, который не удалось очистить.

[in] DeviceObject

Указатель на объект устройства, к которому должна быть подана эта запись журнала.

[in] SectionObjectPointer

Указатель на объект section для файла, в котором произошел сбой очистки.

[in] FlushError

Ошибка, возвращаемая вызовом CcFlushCache.

[in] Flags

Значение 0 или побитовая комбинация одного или нескольких следующих флагов:

Flag	Значение
FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR	Подавляет представление пользователю информационного диалогового окна.
FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY	Подавляет создание записи журнала системных ошибок.

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

Подпрограмма FsRtlLogCcFlushError возвращает STATUS_SUCCESS при успешном выполнении или другом значении NTSTATUS, например STATUS_INSUFFICIENT_RESOURCES.

Если вызов не содержит соответствующих флагов, подпрограмма FsRtlLogCcFlushError использует IoRaiseInformationalHardError для отображения диалогового окна для пользователя, включая конкретную ошибку и Имя файла, и использует IoWriteErrorLogEntry регистрирует ошибку.

Если все имя_файла не может поместиться в буфер журнала, подпрограмма вставляет многоточие в имя файла.

Если кэш по-прежнему содержит страницы, которые были изменены, ошибка не является неустранимой. Подпрограмма возвращается вызывающей объекту без регистрации ошибки или отображения диалогового окна.

Если ошибка неустранима, подпрограмма увеличивает значение счетчика потерянной задержки записи в блоке управления процессором (PRCB). Этот счетчик можно использовать для устранения ошибок потерянной отложенной записи.

Требования

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

См. также раздел

CcFlushCache

IoRaiseInformationalHardError

IoWriteErrorLogEntry

Share via