Funzione CcFlushCache (ntifs.h)
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 a 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 i dati devono essere scaricati.
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 Length .
[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 . Pertanto, il chiamante deve essere in grado di immettere uno stato di attesa fino a quando tutti i dati non sono stati scaricati.
Per memorizzare nella cache un file, usare CcInitializeCacheMap.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Intestazione | ntifs.h (include Ntifs.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |