c++如何创建一个指定大小的稀疏文件_Windows下FSCTL_SET

稀疏文件是操作系统标记逻辑存在但物理未分配区域的文件，需调用FSCTL_SET_SPARSE显式启用：文件须以GENERIC_WRITE打开、已存在且非压缩/加密，DeviceIoControl需传有效FILE_SET_SPARSE_BUFFER结构体。

c++如何创建一个指定大小的稀疏文件_windows下fsctl_set_sparse【实战】

什么是稀疏文件，为什么 Windows 下要用 `FSCTL_SET_SPARSE`

稀疏文件不是“空文件”，而是操作系统层面标记出某些区域“逻辑存在但物理未分配”的文件。它节省磁盘空间，适合日志归档、虚拟磁盘镜像、大数据占位等场景。Windows 不会自动创建稀疏文件，必须显式调用 FSCTL_SET_SPARSE 控制码开启稀疏属性，否则即使你用 SetFilePointerEx 跳过一大段再写，NTFS 仍会把中间全填零并实际分配空间。

调用 `FSCTL_SET_SPARSE` 的前置条件和关键步骤

必须满足三个硬性条件，缺一不可：

文件句柄需以 GENERIC_WRITE 打开，且不能带 FILE_ATTRIBUTE_COMPRESSED
文件必须已存在（不能是刚 CreateFile 出来的空句柄，得先写点内容或至少 SetEndOfFile 拉长）
调用前需确保文件处于非压缩、非加密状态（GetFileAttributes 返回不含 FILE_ATTRIBUTE_COMPRESSED 或 FILE_ATTRIBUTE_ENCRYPTED）

实操建议：先 CreateFile 创建文件 → SetEndOfFile 设定目标大小 → 关闭句柄 → 重新以可写方式打开 → 再发 FSCTL_SET_SPARSE。跳过“先设大小再开句柄”这步，90% 会返回 ERROR_INVALID_PARAMETER。

`DeviceIoControl` 发送 `FSCTL_SET_SPARSE` 的最小安全写法

别直接传空结构体——Windows 要求提供一个非 NULL 的 FILE_SET_SPARSE_BUFFER 指针，哪怕里面 SetSparse 字段为 TRUE 就行。常见错误是传了 NULL 或栈上未初始化的结构，导致调用失败并返回 ERROR_INVALID_USER_BUFFER。

示例片段（关键部分）：

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

FILE_SET_SPARSE_BUFFER sparseBuf = { TRUE };
DWORD bytesReturned;
BOOL ok = DeviceIoControl(
    hFile,
    FSCTL_SET_SPARSE,
    &sparseBuf, sizeof(sparseBuf),
    NULL, 0,
    &bytesReturned,
    NULL
);

注意：DeviceIoControl 成功只表示稀疏属性已启用，不保证后续写入就是稀疏行为——你还得用 SetFileValidData（需管理员权限）或常规写入配合 SetFilePointerEx 跳跃，才能真正避免零填充。

稀疏写入后如何验证是否生效

资源管理器里看“大小”和“占用空间”不同，只是表象。真实判断依据只有两个：

用 fsutil file querysparse C:\path\to\file 命令，输出含 Is Sparse : Yes
用 GetCompressedFileSize 获取“逻辑大小”，再用 GetDiskFreeSpaceEx 配合 GetFileSizeEx 推算实际占用（更准的是解析 $DATA 属性，但太重；日常用 fsutil 足够）

容易被忽略的点：即使启用了稀疏，如果你用 fwrite 或 WriteFile 从头开始连续写满整个范围，NTFS 仍会分配全部空间——稀疏只对“跳着写”有效。真正省空间，靠的是你控制写入偏移，而非单纯开了稀疏属性。