CcGetDirtyPages-Funktion (ntifs.h)

Artikel
12/21/2024

Die CcGetDirtyPages Routinesuchen nach schmutzigen Seiten in allen Dateien, die einem bestimmten Protokollhandle entsprechen.

Syntax

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

Parameter

[in] LogHandle

Log handle stored by a previous call to CcSetLogHandleForFile.

[in] DirtyPageRoutine

Zeigen Sie auf eine Rückrufroutine, die eine schmutzige Seitentabelle aus den gefundenen Seiten erstellt. Diese Routine, die für jede schmutzige 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

Zeigen Sie auf das Dateiobjekt für die Datei, die die geänderte Seite enthält.

FileOffset

Zeigen Sie auf eine Variable, die den Anfangsbyte-Offset der geänderten Seite innerhalb der zwischengespeicherten Datei angibt.

Länge

Länge der geänderten Seite in Byte.

ÄltesteLsn

Älteste logische Sequenznummer (Logical Sequence Number, LSN) auf der schmutzigen Seite.

NeuesteLsn

Der neueste LSN wurde auf der schmutzigen Seite gefunden.

Kontext1

Erster Kontextparameter.

Context2

Zweiter Kontextparameter.

[in] Context1

Erster 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 von schmutzigen Seiten gefunden wurde. Wenn keine schmutzigen Seiten vorhanden sind, gibt CcGetDirtyPages Null zurück.

Bemerkungen

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= DISPATCH_LEVEL

Siehe auch

CcSetDirtyPinnedData-

CcSetLogHandleForFile-

Freigeben über