Funzione MmFlushImageSection (ntifs.h)
La routine MmFlushImageSection scarica la sezione immagine per un file.
Sintassi
BOOLEAN MmFlushImageSection(
PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] MMFLUSH_TYPE FlushType
);
Parametri
SectionObjectPointer
Puntatore a una struttura contenente i puntatori a oggetti sezione dell'oggetto file.
[in] FlushType
Specifica il motivo dell'operazione di scaricamento. Può essere uno dei valori elencati nella tabella seguente.
| Valore FlushType | Significato |
|---|---|
| MmFlushForDelete | Il file viene eliminato. |
| MmFlushForWrite | Il file viene aperto per l'accesso in scrittura. |
Valore restituito
MmFlushImageSection restituisceTRUE se l'operazione di scaricamento ha esito positivo o se non esiste alcuna sezione immagine per il file; in caso contrario , MmFlushImageSection restituisceFALSE.
Commenti
Un file system deve chiamare la routine MmFlushImageSection prima di eliminare un file o aprire un file per l'accesso in scrittura.
Prima di eliminare un file, il file system deve chiamare MmFlushImageSection dalla relativa routine di invio IRP_MJ_SET_INFORMATION o IRP_MJ_CLEANUP, passando MmFlushForDelete per il parametro FlushType .
Quando si apre un file per l'accesso in scrittura, il file system deve chiamare MmFlushImageSection dalla routine di invio IRP_MJ_CREATE, passando MmFlushForWrite per il parametro FlushType .
Se non sono presenti visualizzazioni mappate della sezione immagine, MmFlushImageSection elimina la sezione immagine e restituisce le pagine usate nell'elenco gratuito.
Prima di usare MmFlushImageSection, i writer del file system sono fortemente invitati a studiare il modo in cui questa routine viene usata nell'esempio FASTFAT.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |