CcGetDirtyPages-Funktion (ntifs.h)

  • Artikel

Die CcGetDirtyPages-Routine sucht nach modifiziert Seiten in allen Dateien, die einem angegebenen Protokollhandle entsprechen.

Syntax

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

Parameter

[in] LogHandle

Protokollhandle, das von einem vorherigen Aufruf von CcSetLogHandleForFile gespeichert wurde.

[in] DirtyPageRoutine

Zeiger auf eine Rückrufroutine, die eine modifiziert Seitentabelle aus den gefundenen Seiten erstellt. Diese Routine, die für jede modifiziert gefundenen Seite aufgerufen wird, wird wie folgt deklariert:

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

Zeiger auf das Dateiobjekt für die Datei, die die modifiziert Seite enthält.

FileOffset

Zeiger auf eine Variable, die den Anfangsbyteoffset der modifiziert Seite in der zwischengespeicherten Datei angibt.

Länge

Länge der modifiziert Seite in Bytes.

ÄltesteLsn

Älteste logische Sequenznummer (LSN), die auf der Seite modifiziert gefunden wurde.

NeuesteLsn

Neueste LSN auf der Seite modifiziert gefunden.

Context1

Erster Kontextparameter.

Context2

Zweiter Kontextparameter.

[in] Context1

Der erste Kontextparameter, der an die DirtyPageRoutine übergeben werden soll.

[in] Context2

Zweiter Kontextparameter, der an die DirtyPageRoutine übergeben werden soll.

Rückgabewert

CcGetDirtyPages gibt den ältesten LSN zurück, der in der Gruppe der modifiziert Seiten gefunden wurde. Wenn keine modifiziert Seiten vorhanden sind, gibt CcGetDirtyPages null zurück.

Hinweise

Dateisysteme rufen CcGetDirtyPages auf, um modifiziert Seiten in allen Dateien zurückzugeben, die einem bestimmten Protokollhandle entsprechen. CcGetDirtyPages sucht nach modifiziert Seiten in allen Dateien, die mit dem angegebenen LogHandle übereinstimmen, und ruft die DirtyPageRoutine für jede Seite auf.

Um ein Protokollhandle für eine Datei festzulegen, verwenden Sie CcSetLogHandleForFile.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP
Zielplattform Universell
Header ntifs.h (include Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Weitere Informationen

CcSetDirtyPinnedData

CcSetLogHandleForFile