Función CcFlushCache (ntifs.h)

Artículo
02/29/2024

La rutina CcFlushCache vacía todo o una parte de un archivo almacenado en caché en el disco.

Sintaxis

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

Puntero a una estructura de SECTION_OBJECT_POINTERS que contiene los punteros de objeto de sección del objeto de archivo.

[in, optional] FileOffset

Puntero a una variable que especifica el desplazamiento de bytes inicial dentro del archivo almacenado en caché donde se van a vaciar los datos.

Si FileOffset es NULL, todo el archivo se vacía de la memoria caché.

Si FileOffset no es NULL, solo se vacía el intervalo de bytes especificado por FileOffset y Length .

[in] Length

Longitud del intervalo de bytes que se va a vaciar, empezando por FileOffset. Si FileOffset es NULL, se omite Length .

[out, optional] IoStatus

Puntero a una estructura que recibe el estado de finalización final e información sobre la operación de vaciado. Si los datos se vacían correctamente, IoStatus.Status contiene STATUS_SUCCESS. Si no todos los datos se vacían correctamente, IoStatus.Information contiene el número real de bytes que se han vaciado. De lo contrario, IoStatus.Information contiene el valor especificado en Length.

Valor devuelto

None

Observaciones

CcFlushCache no tiene ningún parámetro Wait . Por lo tanto, el autor de la llamada debe poder especificar un estado de espera hasta que se hayan vaciado todos los datos.

Para almacenar en caché un archivo, use CcInitializeCacheMap.