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
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP |
Plataforma de destino | Universal |
Encabezado | ntifs.h (incluya Ntifs.h) |
Library | NtosKrnl.lib |
Archivo DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |