ZwFlushBuffersFile-Funktion (ntifs.h)

Artikel
07/11/2023

Die ZwFlushBuffersFile-Routine wird von einem Dateisystemfiltertreiber aufgerufen, um eine Leerungsanforderung für die angegebene Datei an das Dateisystem zu senden.

Syntax

NTSYSAPI NTSTATUS ZwFlushBuffersFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock
);

Parameter

[in] FileHandle

Von ZwCreateFile oder ZwOpenFile zurückgegebenes Handle für die Datei, deren Puffer geleert werden. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[out] IoStatusBlock

Adresse des E/A-status blocks des Aufrufers. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

ZwFlushBuffersFile gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_MEDIA_WRITE_PROTECTED	Die Datei befindet sich auf einem schreibgeschützten Volume. Dies ist ein Fehlercode.
STATUS_VOLUME_DISMOUNTED	Die Datei befindet sich auf einem Volume, das derzeit nicht eingebunden ist. Dies ist ein Fehlercode.

Hinweise

Ein Dateisystemfiltertreiber kann ZwFlushBuffersFile aufrufen, um eine IRP_MJ_FLUSH_BUFFERS Anforderung an das Dateisystem für eine bestimmte Datei auszusetzen. Der Leerungsvorgang ist synchron.

Minifiltertreiber sollten FltFlushBuffers anstelle von ZwFlushBuffersFile aufrufen.

Aufrufer von ZwFlushBuffersFile müssen unter IRQL = PASSIVE_LEVEL und mit aktivierten speziellen Kernel-APCs ausgeführt werden.

Hinweis Wenn der Aufruf der ZwFlushBuffersFile-Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtFlushBuffersFile" anstelle von "ZwFlushBuffersFile" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die Versionen **Nt*Xxx*** und **Zw*Xxx*** einer Windows Native System Services-Routine anders verhalten, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Versionen **Nt*Xxx*** und **Zw*Xxx*** einer Routine finden Sie unter [Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen](/windows-hardware/drivers/kernel/using-nt-and-zw-versions-of-the-native-system-services-routines).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (siehe Abschnitt "Hinweise")
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)