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 の値、または次のフラグの 1 つ以上のビットごとの組み合わせ。

旗	意味
FSRTL_CC_FLUSH_ERROR_FLAG_NO_HARD_ERROR	ユーザーへの情報ダイアログ ボックスの表示を抑制します。
FSRTL_CC_FLUSH_ERROR_FLAG_NO_LOG_ENTRY	システム エラー ログ エントリの生成を抑制します。

戻り値

FsRtlLogCcFlushError ルーチンは、成功した場合、または別の NTSTATUS 値 (STATUS_INSUFFICIENT_RESOURCES など) にSTATUS_SUCCESSを返します。

備考

呼び出しに適切な Flagsが含まれている場合を除き、FsRtlLogCcFlushError ルーチンは、IoRaiseInformationalHardError を使用して、特定のエラーや FileNameを含むダイアログ ボックスをユーザーに表示し、IoWriteErrorLogEntry を使用してエラーをログに記録します。

FileName 全体がログ バッファー内に収まらない場合、ルーチンは省略記号をファイル名に挿入します。

キャッシュに変更されたページがまだ存在する場合、エラーは致命的ではありません。 このルーチンは、エラーのログ記録やダイアログ ボックスの表示を行わずに呼び出し元に戻ります。

エラーが致命的な場合、ルーチンは、プロセッサ制御ブロック (PRCB) で失われた遅延書き込みカウンターをインクリメントします。 このカウンターは、失われた遅延書き込みエラーのトラブルシューティングに使用できます。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	万国
ヘッダー	ntifs.h (FltKernel.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

関連項目

CcFlushCache の

IoRaiseInformationalHardError

IoWriteErrorLogEntry