MmFlushImageSection-Funktion (ntifs.h)
Die MmFlushImageSection Routine löscht den Bildabschnitt für eine Datei.
Syntax
BOOLEAN MmFlushImageSection(
PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] MMFLUSH_TYPE FlushType
);
Parameter
SectionObjectPointer
Zeigen Sie auf eine Struktur, die die Abschnittsobjektzeiger des Dateiobjekts enthält.
[in] FlushType
Gibt den Grund für den Löschvorgang an. Es kann sich um einen der Werte handeln, die in der folgenden Tabelle aufgeführt sind.
| FlushType-Wert | Bedeutung |
|---|---|
| MmFlushForDelete | Die Datei wird gelöscht. |
| MmFlushForWrite | Die Datei wird für den Schreibzugriff geöffnet. |
Rückgabewert
MmFlushImageSection- gibt TRUE zurück, wenn der Löschvorgang erfolgreich ist oder kein Bildabschnitt für die Datei vorhanden ist; andernfalls gibt MmFlushImageSectionFALSEzurück.
Bemerkungen
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 Dispatch-Routine 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 Dispatch-Routine aufrufen und MmFlushForWrite- für den parameter FlushType übergeben.
Wenn keine zugeordneten Ansichten des Bildabschnitts vorhanden sind, MmFlushImageSection den Bildabschnitt zerstört und alle verwendeten Seiten an die kostenlose Liste zurückgibt.
Vor der Verwendung von MmFlushImageSectionwerden Dateisystemautoren dringend empfohlen, die Art und Weise zu untersuchen, wie diese Routine im FASTFAT-Beispiel verwendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | < DISPATCH_LEVEL |