Função CcPurgeCacheSection (ntifs.h)

Artigo
12/21/2024

O CcPurgeCacheSection a rotina limpa toda ou uma parte de um arquivo armazenado em cache do cache do sistema.

Sintaxe

BOOLEAN CcPurgeCacheSection(
  [in]           PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in, optional] PLARGE_INTEGER           FileOffset,
  [in]           ULONG                    Length,
                 ULONG                    Flags
);

Parâmetros

[in] SectionObjectPointer

Ponteiro para uma estrutura que contém os ponteiros do objeto de seção do objeto de arquivo.

[in, optional] FileOffset

Ponteiro para uma variável que especifica o deslocamento de bytes inicial dentro do arquivo armazenado em cache em que os dados devem ser limpos.

Se FileOffset for NULL, todo o arquivo será limpo do cache.

Se FileOffset não estiver NULL, somente o intervalo de bytes especificado por FileOffset e Length será limpo.

[in] Length

Comprimento do intervalo de bytes a ser limpo, começando em FileOffset . Se Length for zero, o intervalo de FileOffset até o final do arquivo será limpo. Se FileOffset for NULL, length será ignorado.

Flags

Defina como verdadeiro para não inicializar quaisquer mapas de cache privados para o arquivo antes de limpar os dados do arquivo.

Valor de retorno

CcPurgeCacheSection retornará verdadeiro se os dados de arquivo armazenados em cache tiverem sido limpos com êxito, false caso contrário.

Observações

Os sistemas de arquivos chamam CcPurgeCacheSection para limpar dados obsoletos do cache. Por exemplo, quando um arquivo é truncado, mas não excluído, ccPurgeCacheSection deve ser chamado para limpar os dados armazenados em cache que não fazem mais parte do arquivo.

CcPurgeCacheSection não limpará os arquivos mapeados.

Antes de chamar CcPurgeCacheSection, o chamador deve adquirir o arquivo exclusivamente e garantir que nenhum thread, incluindo o chamador, tenha mapeado ou fixado qualquer intervalo de bytes no arquivo.

Requisitos

Requisito	Valor
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

CcFlushCache

CcInitializeCacheMap

CcIsFileCached

ccUninitializeCacheMap

MmFlushImageSection

Compartilhar via