Função CcGetDirtyPages (ntifs.h)

A rotina CcGetDirtyPages pesquisa páginas sujo em todos os arquivos que correspondem a um determinado identificador de log.

Sintaxe

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

Parâmetros

[in] LogHandle

Identificador de log armazenado por uma chamada anterior para CcSetLogHandleForFile.

[in] DirtyPageRoutine

Ponteiro para uma rotina de retorno de chamada que compila uma tabela de página sujo das páginas encontradas. Essa rotina, que é chamada para cada página de sujo encontrada, é declarada da seguinte maneira:

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

Ponteiro para o objeto de arquivo do arquivo que contém a página sujo.

FileOffset

Ponteiro para uma variável que especifica o deslocamento de bytes inicial da página sujo dentro do arquivo armazenado em cache.

Comprimento

Comprimento, em bytes, da página sujo.

OldestLsn

LSN (número de sequência lógica) mais antigo encontrado na página sujo.

NewestLsn

LSN mais recente encontrado na página sujo.

Context1

Primeiro parâmetro de contexto.

Context2

Segundo parâmetro de contexto.

[in] Context1

Primeiro parâmetro de contexto a ser passado para o DirtyPageRoutine.

[in] Context2

Segundo parâmetro de contexto a ser passado para o DirtyPageRoutine.

Retornar valor

CcGetDirtyPages retorna o LSN mais antigo encontrado no conjunto de páginas sujo. Se não houver páginas sujo, CcGetDirtyPages retornará zero.

Comentários

Os sistemas de arquivos chamam CcGetDirtyPages para retornar sujo páginas em todos os arquivos que correspondem a um determinado identificador de log. CcGetDirtyPages pesquisa páginas sujo em todos os arquivos que correspondem ao LogHandle especificado e chama DirtyPageRoutine para cada página.

Para definir um identificador de log para um arquivo, use CcSetLogHandleForFile.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Confira também

CcSetDirtyPinnedData

CcSetLogHandleForFile