Função CcGetDirtyPages (ntifs.h)

Artigo
12/21/2024

O CcGetDirtyPages pesquisas de rotina por páginas sujas 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 suja das páginas encontradas. Essa rotina, que é chamada para cada página suja 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 para o arquivo que contém a página suja.

FileOffset

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

Comprimento

Comprimento, em bytes, da página suja.

OldestLsn

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

NewestLsn

LSN mais recente encontrado na página suja.

Context1

Primeiro parâmetro de contexto.

Context2

Segundo parâmetro de contexto.

[in] Context1

Primeiro parâmetro de contexto a ser passado para oDirtyPageRoutine .

[in] Context2

Segundo parâmetro de contexto a ser passado para oDirtyPageRoutine .

Valor de retorno

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

Observações

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

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

Requisitos

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

Consulte também

CcSetDirtyPinnedData

ccSetLogHandleForFile

Compartilhar via