Función CcPurgeCacheSection (ntifs.h)
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.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Universal |
Encabezado | ntifs.h (incluya Ntifs.h) |
Library | NtosKrnl.lib |
Archivo DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |