CcGetDirtyPages 函式 （ntifs.h）

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

第二個內容參數。

[in] Context1

要傳遞至 DirtyPageRoutine的第一個內容參數。

[in] Context2

要傳遞至 DirtyPageRoutine 的第二個內容參數。

傳回值

CcGetDirtyPages 會傳回在一組骯髒頁面中找到的最舊 LSN。 如果沒有髒頁面，CcGetDirtyPages 會傳回零。

言論

文件系統會呼叫 CcGetDirtyPages 傳回所有符合指定記錄句柄之檔案中的髒頁面。 CcGetDirtyPages 搜尋所有符合指定 logHandle 的檔案中的髒頁面，並針對每個頁面呼叫 DirtyPageRoutine。

若要設定檔案的記錄句柄，請使用 CcSetLogHandleForFile。

要求

另請參閱

CcSetDirtyPinnedData

CcSetLogHandleForFile