Funzione CcFlushCache (ntifs.h)

Articolo
12/21/2024

La routine CcFlushCache scarica tutto o una parte di un file memorizzato nella cache su disco.

Sintassi

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

Parametri

[in] SectionObjectPointer

Puntatore a una struttura SECTION_OBJECT_POINTERS contenente i puntatori agli oggetti sezione dell'oggetto file.

[in, optional] FileOffset

Puntatore a una variabile che specifica l'offset di byte iniziale all'interno del file memorizzato nella cache in cui devono essere scaricati i dati.

Se FileOffset è NULL, l'intero file viene scaricato dalla cache.

Se FileOffset non è null, viene scaricato solo l'intervallo di byte specificato da FileOffset e Lunghezza.

[in] Length

Lunghezza dell'intervallo di byte da scaricare, a partire da FileOffset. Se FileOffset è NULL, la lunghezza viene ignorata.

[out, optional] IoStatus

Puntatore a una struttura che riceve lo stato di completamento finale e informazioni sull'operazione di scaricamento. Se i dati vengono scaricati correttamente, IoStatus.Status contiene STATUS_SUCCESS. Se non tutti i dati vengono scaricati correttamente, IoStatus.Information contiene il numero effettivo di byte scaricati. In caso contrario, IoStatus.Information contiene il valore specificato in Length.

Valore restituito

Nessuno

Osservazioni

CcFlushCache non ha alcun parametro Wait. Il chiamante deve quindi essere in grado di immettere uno stato di attesa fino a quando non vengono scaricati tutti i dati.

Per memorizzare nella cache un file, usare CcInitializeCacheMap.