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é.

Length

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 va a pasar a DirtyPageRoutine.

[in] Context2

Segundo parámetro de contexto que se va a pasar a DirtyPageRoutine.

Valor devuelto

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

Comentarios

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 a DirtyPageRoutine para cada página.

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

Requisitos

Consulte también

CcSetDirtyPinnedData

CcSetLogHandleForFile