FsRtlLogCcFlushError 函式 (ntifs.h)

  • 發行項

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

排清失敗之檔案的區段物件的指標。

[in] FlushError

呼叫 CcFlushCache 所傳回的錯誤。

[in] Flags

值 0 或下列一或多個旗標的位元組合：

旗標 意義
FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR 隱藏向用戶呈現資訊對話方塊。
FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY 隱藏系統錯誤記錄項目的產生。

傳回值

FsRtlLogCcFlushError 例程會在成功或其他 NTSTATUS 值時傳回STATUS_SUCCESS，例如 STATUS_INSUFFICIENT_RESOURCES。

備註

除非呼叫包含適當的 旗標， 否則 FsRtlLogCcFlushError 例程會使用 IoRaiseInformationalHardError 向使用者顯示對話框，包括特定的錯誤和 FileName，並使用 IoWriteErrorLogEntry 記錄 錯誤。

如果整個 FileName 無法容納在記錄緩衝區內，例程會將省略號插入檔名中。

如果快取仍有已修改的頁面，則錯誤並不嚴重。 例程會傳回給呼叫端，而不記錄錯誤或顯示對話方塊。

如果錯誤嚴重，例程會遞增處理器控制區塊中遺失的延遲寫入計數器， (中國B) 。 此計數器可用於針對遺失延遲寫入錯誤進行疑難解答。

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 Universal
標頭 ntifs.h (包含 FltKernel.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

CcFlushCache

IoRaiseInformationalHardError

IoWriteErrorLogEntry