CcGetDirtyPages 関数 (ntifs.h)

[アーティクル]
08/07/2023

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
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

こちらもご覧ください

CcSetDirtyPinnedData

CcSetLogHandleForFile

次の方法で共有