Compartir a través de


Función CcFlushCache (ntifs.h)

El CcFlushCache rutina 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 vacia, empezando por FileOffset. Si FileOffset es NULL, se omite longitud.

[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 vaciaron. De lo contrario, ioStatus.Information contiene el valor especificado en Longitud.

Valor devuelto

Ninguno

Observaciones

CcFlushCache no tiene 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.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
encabezado de ntifs.h (incluya Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe

Consulte también

ccCopyWrite

CcInitializeCacheMap

ccIsFileCached

CcPurgeCacheSection