ccGetDirtyPages 函式 (ntifs.h)

發行項
02/26/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

第二個內容參數。

[in] Context1

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

[in] Context2

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

傳回值

CcGetDirtyPages 會傳回在一組中途分頁中找到的最舊 LSN。如果沒有變更的頁面， CcGetDirtyPages 會 傳回零。

備註

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

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

規格需求

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

另請參閱

CcSetDirtyPinnedData

CcSetLogHandleForFile

共用方式為