CcGetDirtyPages 関数 (ntifs.h)

[アーティクル]
12/21/2024

CcGetDirtyPages ルーチンは、特定のログハンドルに一致するすべてのファイル内のダーティページを検索します。

構文

LARGE_INTEGER CcGetDirtyPages(
  [in] PVOID               LogHandle,
  [in] PDIRTY_PAGE_ROUTINE DirtyPageRoutine,
  [in] PVOID               Context1,
  [in] PVOID               Context2
);

パラメーター

[in] LogHandle

CcSetLogHandleForFileへの以前の呼び出しによって格納されたログハンドル。

[in] DirtyPageRoutine

見つかったページからダーティページテーブルを構築するコールバックルーチンへのポインター。このルーチンは、見つかった各ダーティページに対して呼び出され、次のように宣言されます。

typedef
VOID (*PDIRTY_PAGE_ROUTINE) (
            IN PFILE_OBJECT FileObject,
            IN PLARGE_INTEGER FileOffset,
            IN ULONG Length,
            IN PLARGE_INTEGER OldestLsn,
            IN PLARGE_INTEGER NewestLsn,
            IN PVOID Context1,
            IN PVOID Context2
            );

FileObject

ダーティページを含むファイルのファイルオブジェクトへのポインター。

FileOffset

キャッシュされたファイル内のダーティページの開始バイトオフセットを指定する変数へのポインター。

長さ

ダーティページの長さ (バイト単位)。

OldestLsn

ダーティページで見つかった最も古い論理シーケンス番号 (LSN)。

NewestLsn

ダーティページで見つかった最新の LSN。

Context1

最初のコンテキストパラメーター。

Context2

2 番目のコンテキストパラメーター。

[in] Context1

DirtyPageRoutineに渡される最初のコンテキストパラメーター。

[in] Context2

DirtyPageRoutineに渡される 2 番目のコンテキストパラメーター。

戻り値

CcGetDirtyPages は、ダーティページのセットで見つかった最も古い LSN を返します。ダーティページがない場合、ccGetDirtyPages は 0 を返します。

備考

ファイルシステムは ccGetDirtyPages 呼び出して、特定のログハンドルに一致するすべてのファイルのダーティページを返します。 CcGetDirtyPages 指定された LogHandle に一致するすべてのファイル内のダーティページを検索し、各ページの DirtyPageRoutine を呼び出します。

ファイルのログハンドルを設定するには、CcSetLogHandleForFileを使用します。

必要条件

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

次の方法で共有