ZwFlushBuffersFile-Funktion (ntifs.h)

Die ZwFlushBuffersFile Routine wird von einem Dateisystemfiltertreiber aufgerufen, um eine leeren Anforderung 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

Handle, das von ZwCreateFile oder ZwOpenFile- für die Datei zurückgegeben wird, deren Puffer geleert werden. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[out] IoStatusBlock

Adresse des E/A-Statusblocks des Anrufers. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

Rückgabewert

ZwFlushBuffersFile- gibt STATUS_SUCCESS oder einen entsprechenden 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 bereitgestellt ist; Dies ist ein Fehlercode.

Bemerkungen

Ein Dateisystemfiltertreiber kann ZwFlushBuffersFile- aufrufen, um eine IRP_MJ_FLUSH_BUFFERS Anforderung an das Dateisystem für eine bestimmte Datei auszugeben. Der Löschvorgang ist synchron.

Minifiltertreiber sollten FltFlushBuffers aufrufen, anstatt ZwFlushBuffersFile-aufzurufen.

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL (siehe Abschnitt "Hinweise")
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Siehe auch

FltFlushBuffers

IRP_MJ_FLUSH_BUFFERS

Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienste-Routinen

ZwCreateFile-

ZwOpenFile-