Funzione MmFlushImageSection (ntifs.h)

  • Articolo

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.

Nota Se viene specificato il valore FlushType MmFlushForDelete e sono presenti uno o più probe di scrittura in sospeso nella sezione dati del file, 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

Vedi anche

CcPurgeCacheSection