ZwFlushBuffersFile 函数（ntifs.h）

项目
12/21/2024

ZwFlushBuffersFile 例程由文件系统筛选器驱动程序调用，以将指定文件的刷新请求发送到文件系统。

语法

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

参数

[in] FileHandle

ZwCreateFile 或 ZwOpenFile 刷新其缓冲区的文件返回的句柄。此参数是必需的，不能 NULL。

[out] IoStatusBlock

调用方 I/O 状态块的地址。此参数是必需的，不能 NULL。

返回值

ZwFlushBuffersFile 返回STATUS_SUCCESS或适当的 NTSTATUS 值，例如以下值之一：

返回代码	描述
STATUS_MEDIA_WRITE_PROTECTED	该文件驻留在受写保护的卷上;这是一个错误代码。
STATUS_VOLUME_DISMOUNTED	该文件驻留在当前未装载的卷上;这是一个错误代码。

言论

文件系统筛选器驱动程序可以调用 ZwFlushBuffersFile，向给定文件的文件系统发出 IRP_MJ_FLUSH_BUFFERS 请求。刷新操作是同步的。

微型筛选器驱动程序应调用 FltFlushBuffers，而不是调用 ZwFlushBuffersFile。

ZwFlushBuffersFile 的调用方必须在 IRQL = PASSIVE_LEVEL 上运行，启用了特殊内核 APC。

注意如果对 ZwFlushBuffersFile 函数的调用在用户模式下发生，则应使用名称“NtFlushBuffersFile”而不是“ZwFlushBuffersFile”。

对于内核模式驱动程序的调用，Windows Native System Services 例程的 **Nt*Xxx*** 和 **Zw*Xxx*** 版本的行为方式可能有所不同，因为它们处理和解释输入参数的方式不同。有关例程的 Nt*Xxx*** 和 **Zw*Xxx*** 版本之间的关系的详细信息，请参阅 [使用本机系统服务例程的 Nt 和 Zw 版本]（/windows-hardware/drivers/kernel/using-nt-and-zw-versions-of-the-native-system-services-routines）。

要求

要求	价值
最低支持的客户端	Windows Vista
目标平台	普遍
标头	ntifs.h （include Ntifs.h）
库	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL（请参阅“备注”部分）
DDI 符合性规则	HwStorPortProhibitedDIS（storport），PowerIrpDDis（wdm）