MmFlushImageSection-Funktion (ntifs.h)

Die MmFlushImageSection-Routine leert den Bildabschnitt für eine Datei.

Syntax

BOOLEAN MmFlushImageSection(
       PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in] MMFLUSH_TYPE             FlushType
);

Parameter

SectionObjectPointer

Zeiger auf eine Struktur, die die Abschnittsobjektzeiger des Dateiobjekts enthält.

[in] FlushType

Gibt den Grund für den Leerungsvorgang an. Dies kann einer der in der folgenden Tabelle aufgeführten Werte sein.

Rückgabewert

MmFlushImageSection gibt TRUE zurück, wenn der Leerungsvorgang erfolgreich ist oder wenn kein Bildabschnitt für die Datei vorhanden ist. Andernfalls gibt MmFlushImageSectionFALSE zurück.

Hinweise

Ein Dateisystem muss die MmFlushImageSection-Routine aufrufen, bevor eine Datei gelöscht oder eine Datei für den Schreibzugriff geöffnet wird.

Vor dem Löschen einer Datei sollte das Dateisystem MmFlushImageSection aus seiner IRP_MJ_SET_INFORMATION oder IRP_MJ_CLEANUP Dispatchroutine aufrufen und MmFlushForDelete für den FlushType-Parameter übergeben.

Beim Öffnen einer Datei für den Schreibzugriff sollte das Dateisystem MmFlushImageSection aus seiner IRP_MJ_CREATE Dispatchroutine aufrufen und MmFlushForWrite für den FlushType-Parameter übergeben.

Wenn keine zugeordneten Ansichten des Bildabschnitts vorhanden sind, zerstört MmFlushImageSection den Bildabschnitt und gibt alle verwendeten Seiten an die freie Liste zurück.

Vor der Verwendung von MmFlushImageSection werden Dateisystemautoren dringend empfohlen, die Art und Weise zu untersuchen, wie diese Routine im FASTFAT-Beispiel verwendet wird.

Anforderungen

Weitere Informationen

CcPurgeCacheSection