FsRtlLogCcFlushError function (ntifs.h)

The FsRtlLogCcFlushError routine logs a lost delayed-write error and displays a dialog box to the user.

Syntax

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

Parameters

[in] FileName

The name of the file that could not be flushed.

[in] DeviceObject

A pointer to the device object that this log entry should be filed against.

[in] SectionObjectPointer

A pointer to the section object for the file on which the flush failed.

[in] FlushError

The error returned by the call to CcFlushCache.

[in] Flags

A value of 0 or a bitwise combination of one or more of the following flags:

Return value

The FsRtlLogCcFlushError routine returns STATUS_SUCCESS on success or another NTSTATUS value, such as STATUS_INSUFFICIENT_RESOURCES.

Remarks

Unless the call includes appropriate Flags, the FsRtlLogCcFlushError routine uses IoRaiseInformationalHardError to display a dialog box to the user, including the specific error and FileName, and uses IoWriteErrorLogEntry logs the error.

If the entire FileName cannot fit within the log buffer, the routine inserts an ellipsis into the file name.

If the cache still has pages that have been modified, the error is not fatal. The routine returns to the caller without logging an error or displaying the dialog box.

If the error is fatal, the routine increments the lost delayed write counter in the processor control block (PRCB). This counter can be used in troubleshooting lost delayed write errors.

Requirements

See also

CcFlushCache

IoRaiseInformationalHardError

IoWriteErrorLogEntry