Función CcGetDirtyPages (ntifs.h)

La rutina CcGetDirtyPages busca páginas sucias en todos los archivos que coinciden con un identificador de registro determinado.

Sintaxis

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

Parámetros

[in] LogHandle

Identificador de registro almacenado por una llamada anterior a CcSetLogHandleForFile.

[in] DirtyPageRoutine

Puntero a una rutina de devolución de llamada que crea una tabla de páginas sucias a partir de las páginas encontradas. Esta rutina, a la que se llama para cada página desfasada encontrada, se declara de la siguiente manera:

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

Puntero al objeto de archivo del archivo que contiene la página desfasada.

FileOffset

Puntero a una variable que especifica el desplazamiento de bytes inicial de la página desfasada dentro del archivo almacenado en caché.

Largura

Longitud, en bytes, de la página desfasada.

OldestLsn

Número de secuencia lógica (LSN) más antiguo que se encuentra en la página desfasada.

NewestLsn

LSN más reciente encontrado en la página desfasada.

Context1

Primer parámetro de contexto.

Context2

Segundo parámetro de contexto.

[in] Context1

Primer parámetro de contexto que se pasará al DirtyPageRoutine.

[in] Context2

Segundo parámetro de contexto que se pasará al DirtyPageRoutine.

Valor devuelto

CcGetDirtyPages devuelve el LSN más antiguo que se encuentra en el conjunto de páginas sucias. Si no hay páginas desfasadas, CcGetDirtyPages devuelve cero.

Observaciones

Los sistemas de archivos llaman a CcGetDirtyPages para devolver páginas sucias en todos los archivos que coinciden con un identificador de registro determinado. CcGetDirtyPages busca páginas desfasadas en todos los archivos que coinciden con el LogHandle especificado y llama al DirtyPageRoutine para cada página.

Para establecer un identificador de registro para un archivo, use CcSetLogHandleForFile.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= DISPATCH_LEVEL

Consulte también

CcSetDirtyPinnedData

CcSetLogHandleForFile