Función CcPurgeCacheSection (ntifs.h)

Artículo
02/27/2024

La rutina CcPurgeCacheSection purga todo o una parte de un archivo almacenado en caché de la memoria caché del sistema.

Sintaxis

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

Parámetros

[in] SectionObjectPointer

Puntero a una estructura 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 purgar los datos.

Si FileOffset es NULL, se purga todo el archivo de la memoria caché.

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

[in] Length

Longitud del intervalo de bytes que se va a purgar, empezando por FileOffset. Si Length es cero, se purga el intervalo de FileOffset al final del archivo. Si FileOffset es NULL, se omite Length .

Flags

Establézcalo en TRUE para anular la inicialización de las asignaciones de caché privada del archivo antes de purgar los datos del archivo.

Valor devuelto

CcPurgeCacheSection devuelve TRUE si los datos del archivo almacenados en caché se purgaron correctamente; de lo contrario, FALSE .

Comentarios

Los sistemas de archivos llaman a CcPurgeCacheSection para purgar datos obsoletos de la memoria caché. Por ejemplo, cuando se trunca un archivo pero no se elimina, se debe llamar a CcPurgeCacheSection para purgar los datos almacenados en caché que ya no formen parte del archivo.

CcPurgeCacheSection no purgará los archivos asignados.

Antes de llamar a CcPurgeCacheSection, el autor de la llamada debe adquirir el archivo exclusivamente y asegurarse de que ningún subproceso, incluido el autor de la llamada, haya asignado o anclado ningún intervalo de bytes en el archivo.