FltFlushBuffers-Funktion (fltkernel.h)
Die FltFlushBuffers Routine wird vom Minifiltertreiber verwendet, um eine flush-Anforderung für eine bestimmte Datei an das Dateisystem zu senden. Verwenden Sie FltFlushBuffers2-, um unterschiedliche Leertypoptionen anzugeben.
Syntax
NTSTATUS FLTAPI FltFlushBuffers(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject
);
Parameter
[in] Instance
Undurchsichtiger Instanzzeiger für den Aufrufer. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
[in] FileObject
Dateiobjektzeiger für die Datei, die geleert werden soll. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
Rückgabewert
FltFlushBuffers gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Datei befindet sich auf einem schreibgeschützten Volume. Dies ist ein Fehlercode. |
|
Die Datei befindet sich auf einem Volume, das derzeit nicht bereitgestellt wird. Dies ist ein Fehlercode. |
Bemerkungen
Ein Minifiltertreiber kann FltFlushBuffers- aufrufen, um eine IRP_MJ_FLUSH_BUFFERS Anforderung an das Dateisystem für eine bestimmte Datei auszugeben. Der Flush-Vorgang ist synchron und wird an die Instanzen unterhalb der angegebenen Instanceausgegeben.
Wenn FileObject- für eine Datei gilt, werden sowohl die Dateidaten als auch die Metadaten im Dateicache geschrieben, und der zugrunde liegende Speicher wird synchronisiert, um den Cache zu leeren. Wenn FileObject- für ein Volume vorgesehen ist, bewirkt das Dateisystem sowohl die Dateidaten als auch die Metadaten für alle geänderten Dateien auf dem Volume, und der zugrunde liegende Speicher wird synchronisiert, um den Cache zu leeren. Verwenden Sie FltFlushBuffers2-, um den flush-Typ genauer zu steuern, den das Dateisystem ausführen soll.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| IRQL- | PASSIVE_LEVEL |