Função CcFlushCache (ntifs.h)

Artigo
03/01/2024

A rotina CcFlushCache libera todo ou uma parte de um arquivo armazenado em cache no disco.

Sintaxe

void CcFlushCache(
  [in]            PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in, optional]  PLARGE_INTEGER           FileOffset,
  [in]            ULONG                    Length,
  [out, optional] PIO_STATUS_BLOCK         IoStatus
);

Parâmetros

[in] SectionObjectPointer

Ponteiro para uma estrutura SECTION_OBJECT_POINTERS que contém os ponteiros de 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 liberados.

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

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

[in] Length

Comprimento do intervalo de bytes a ser liberado, começando em FileOffset. Se FileOffset for NULL, Length será ignorado.

[out, optional] IoStatus

Ponteiro para uma estrutura que recebe o status de conclusão final e informações sobre a operação de liberação. Se os dados forem liberados com êxito, IoStatus.Status conterá STATUS_SUCCESS. Se nem todos os dados forem liberados com êxito, IoStatus.Information conterá o número real de bytes que foram liberados. Caso contrário, IoStatus.Information contém o valor fornecido em Length.

Retornar valor

Nenhum

Comentários

CcFlushCache não tem parâmetro Wait . Portanto, o chamador deve ser capaz de inserir um estado de espera até que todos os dados sejam liberados.

Para armazenar em cache um arquivo, use CcInitializeCacheMap.