深入解析 Windows fastfat 文件系统驱动示例:以 FAT 为蓝本构建新文件系统
深入解析 Windows fastfat 文件系统驱动示例:以 FAT 为蓝本构建新文件系统
本文以 Windows-driver-samples 仓库中的 fastfat 示例为核心,系统讲解这个以 Windows 内置 FAT 文件系统为蓝本的完整文件系统驱动:涵盖其通用 Windows 驱动(Universal Windows Driver)合规特性、Visual Studio 与 MSBuild 两种构建方式、安装与替换机制,并结合仓库源码剖析其磁盘结构、IRP 分发、FastIo 与缓存管理协同的实现骨架,为编写新文件系统提供可复制的工程范式。
示例定位:一个“完整”而非“教学片段”的文件系统驱动
fastfat 不是一段孤立的教学代码,而是一个功能完整的文件系统驱动,其定位是作为编写新文件系统的模型。根据 filesys/fastfat/README.md 的说明,它完整覆盖了一个真实文件系统需要面对的各类问题:
- 在磁盘上存储数据:处理 FAT 文件系统卷的扇区、簇、文件分配表等底层布局;
- 与缓存管理器(Cache Manager)交互:通过
CcInitializeCacheMap等接口建立文件数据缓存映射,实现高性能读写; - 处理各类 I/O 操作:文件创建(create)、文件读写(read/write)、设置文件信息(set information)、对文件系统执行控制操作(control operations)等。
值得强调的是,它是一份“完整”的实现,这一点在仓库中得到了直接印证:仅 filesys/fastfat 目录下就包含 40 余个 C 源文件,从 create.c、read.c、write.c 到 pnp.c、shutdown.c、lockctrl.c、devctrl.c、ea.c,覆盖了文件系统驱动的典型职责面。这意味着读者可以从一个真实、可编译、随 Windows 内置驱动同源的实现出发,逐模块学习文件系统驱动开发。
Universal Windows Driver(UWD)合规
该示例构建为通用 Windows 驱动。README 明确说明:它只使用包含在 OneCoreUAP 中的 API 和 DDI(Device Driver Interface),即不依赖仅在完整桌面版 Windows 中存在的内核接口。
这一合规要求在工程配置上体现得非常具体。查看 fastfat.vcxproj,可以发现每个配置(Debug|ARM64、Release|ARM64、Debug|x64、Release|x64)都显式设置了:
<TargetVersion>Windows10</TargetVersion>——目标系统版本为 Windows 10 及以上的统一内核;<DriverTargetPlatform>Windows Driver</DriverTargetPlatform>——构建目标为通用 Windows 驱动平台;<PlatformToolset>WindowsKernelModeDriver10.0</PlatformToolset>——使用 WDK 10 的内核模式驱动工具集;<DriverType>WDM</DriverType>——WDM 类型驱动;<ConfigurationType>Driver</ConfigurationType>——输出为驱动二进制fastfat.sys。
同时,所有配置都启用了 Level4 警告级别并将警告视为错误(<WarningLevel>Level4</WarningLevel> + <TreatWarningAsError>true</TreatWarningAsError>),并对驱动签名使用 sha256 文件摘要算法(<FileDigestAlgorithm>sha256</FileDigestAlgorithm>)。这种“高警告等级 + 警告即错误”的做法,正是面向系统级驱动代码质量的最佳实践。
从源码角度同样可以佐证其通用性:fatprocs.h 仅包含 ntifs.h 及 ntddscsi.h、scsi.h、ntddcdrm.h、ntdddisk.h、ntddstor.h、ntintsafe.h 等通用内核头文件,没有引用任何桌面版专属接口。此外,fatinit.c 中的 DriverEntry 同时创建两个文件系统设备对象:
\Fat(FILE_DEVICE_DISK_FILE_SYSTEM)——为磁盘卷提供 FAT 挂载;\FatCdrom(FILE_DEVICE_CD_ROM_FILE_SYSTEM)——为 CD-ROM 卷提供 FAT/ISO 挂载支持。
这两个设备对象对应 fatstruc.h 中 FAT_DATA 记录的 DiskFileSystemDeviceObject 与 CdromFileSystemDeviceObject 字段,体现了 FAT 文件系统同时服务磁盘介质与光盘介质的设计。
构建示例
README 提供了两种构建方式:Visual Studio 图形界面与 MSBuild 命令行。两者产出的都是 fastfat.sys,选择哪种取决于开发者的工作流习惯。
方式一:使用 Visual Studio 构建
构建驱动与构建普通 Visual Studio 项目/解决方案的方式相同。默认解决方案配置为 Debug 与 Win32;不过从仓库实际的 fastfat.sln 与 fastfat.vcxproj 来看,本示例当前支持的平台组合是 x64 与 ARM64 下的 Debug/Release 四种配置,并没有 Win32/x86 配置——因此实际操作时应选择 x64 或 ARM64 平台。
具体步骤(摘自 README,并结合仓库配置补充说明):
- 在 Visual Studio 中打开
fastfat.sln(或直接打开fastfat.vcxproj项目文件); - 在解决方案资源管理器中右键解决方案,选择配置管理器;
- 在配置管理器中选择与目标构建对应的活动解决方案配置(Debug 或 Release)与活动解决方案平台(x64 或 ARM64);
- 从生成菜单点击生成解决方案(快捷键
Ctrl+Shift+B)。
提示:当你基于 Windows 驱动模板新建驱动项目,或从旧版 WDK 源码转换项目时,Visual Studio 的转换过程会保留目标版本信息(操作系统与平台)。因此从既有 WDK 代码迁移到本示例的工程结构,目标平台信息不会丢失。
方式二:使用命令行(MSBuild)构建
旧版 WDK 使用 Build.exe 并为每种构建配置提供独立的构建环境窗口;现在则统一使用 Visual Studio 命令提示符中的 MSBuild.exe 完成所有配置的构建。
步骤(摘自 README,命令已针对仓库实际项目名校正):
- 从开始屏幕打开一个 Visual Studio 命令提示符窗口(此窗口环境中可找到
MsBuild.exe); - 进入项目目录,对目标项目执行
msbuild命令。例如,对 fastfat 项目执行一次“先清理再完整构建”的命令:
msbuild /t:clean /t:build .\fastfat.vcxproj
这条命令在项目根目录(filesys/fastfat/)下运行,/t:clean /t:build 依次执行清理与构建目标。若希望以指定配置构建,可追加 /p:Configuration=Release /p:Platform=x64 等属性覆盖默认值。
从 fastfat.vcxproj 可以看到,所有 C 源文件(AcChkSup.c、AllocSup.c、CacheSup.c、Cleanup.c、Close.c、Create.c、DevCtrl.c、DevIoSup.c、DirCtrl.c、DirSup.c、DumpSup.c、Ea.c、EaSup.c、FatData.c、FatInit.c、FileInfo.c、FilObSup.c、Flush.c、FsCtrl.c、FspDisp.c、LockCtrl.c、NameSup.c、Pnp.c、Read.c、ResrcSup.c、Shutdown.c、SplaySup.c、StrucSup.c、TimeSup.c、VerfySup.c、VolInfo.c、WorkQue.c、Write.c 等)共同参与编译,其中 fatprocssrc.c 负责创建预编译头(PreCompiledHeader=Create),其余源文件统一使用 fatprocs.h 作为预编译头(PreCompiledHeader=Use),输出到 $(IntDir)\fatprocs.h.pch,这是一个大型内核驱动项目典型的 PCH 组织方式。
安装与替换:无 INF 的私有版本部署
与大多数需要 INF 安装包的驱动示例不同,本示例不提供任何 INF 文件。README 给出的原因非常直接:fastfat 文件系统驱动(fastfat.sys)已经是 Windows 操作系统内置组件,无需再通过 INF 进行设备安装。
那么这份示例的实际价值在哪里?README 指出:你可以构建该文件系统的私有版本,并把它作为本机原生驱动的替换品使用。这意味着典型的使用场景是:
- 修改源码(例如为学习或实验目的加入自己的逻辑);
- 构建出私有版
fastfat.sys; - 用其替换 Windows 自带的 FAT 文件系统驱动进行调试、教学或验证。
由于它是随系统分发的驱动,任何对磁盘数据格式的误操作都可能影响系统稳定性,建议仅在虚拟机或测试环境中进行替换实验。同时需要注意,本仓库为只读资源,文章中仅介绍构建与替换方式,不涉及修改仓库内容的操作。
源码级剖析:从磁盘布局到 I/O 分发
要真正“以 fastfat 为模型写新文件系统”,需要理解它组织代码的四个层次:磁盘格式定义 → 内存数据结构 → 初始化与分发 → 各 IRP 处理模块。以下均可在仓库源码中找到一一对应。
磁盘结构定义:fat.h
fat.h 是理解 FAT 卷格式的入口,定义了:
- 编址术语:
LBN(逻辑扇区号,相对磁盘起始)、VBN(卷区号,相对文件/目录/分配区起始)、LBO(相对磁盘的字节偏移)、VBO(相对文件/目录的字节偏移);并定义LBO为 64 位(注释明确指出“for Fat32, LBO is >32 bits”),适应 FAT32 大容量卷; - 压缩与解压缩的 BIOS 参数块(BPB):
PACKED_BIOS_PARAMETER_BLOCK与PACKED_BIOS_PARAMETER_BLOCK_EX描述扇区上未对齐的原始字节布局(BytesPerSector、SectorsPerCluster、ReservedSectors、Fats、RootEntries、SectorsPerFat、LargeSectorsPerFat、RootDirFirstCluster、FsInfoSector等),BIOS_PARAMETER_BLOCK为内存中的解包版本,FatUnpackBios宏完成两者转换; - 引导扇区:
PACKED_BOOT_SECTOR/PACKED_BOOT_SECTOR_EX,包含跳转指令、OEM 名、BPB、物理驱动器号、卷标与SystemId; - FAT32 的 FSInfo 扇区:
FSINFO_SECTOR记录FsInfoSignature、FreeClusterCount、NextFreeCluster等空闲簇信息; - 判定宏:
IsBpbFat32(bpb)通过检查SectorsPerFat字段是否为 0 来区分 FAT12/16 与 FAT32。
这些定义构成了任何文件系统驱动都必须解决的“如何解读与组织磁盘元数据”问题的参考答案。
内存数据结构与节点类型:fatstruc.h / nodetype.h
Windows 文件系统驱动使用“节点类型码 + 节点字节大小”作为内存记录的统一头。仓库中 nodetype.h 定义了这一模式:
typedef struct _RECORD_NAME {
NODE_TYPE_CODE NodeTypeCode;
NODE_BYTE_SIZE NodeByteSize;
...
} RECORD_NAME;
并预定义了 FAT 驱动的核心节点类型码:FAT_NTC_DATA_HEADER (0x0500)、FAT_NTC_VCB (0x0501)、FAT_NTC_FCB (0x0502)、FAT_NTC_DCB (0x0503)、FAT_NTC_ROOT_DCB (0x0504)、FAT_NTC_CCB (0x0507)、FAT_NTC_IRP_CONTEXT (0x0508)。
fatstruc.h 则定义了这些记录的具体形态,其中核心是:
FAT_DATA(数据头):整个文件系统的全局记录,必须分配在非分页池。包含已挂载卷队列VcbQueue、两个文件系统设备对象指针、全局ERESOURCE、缓存管理器回调CacheManagerCallbacks、异步/延迟关闭队列(AsyncCloseList/DelayedCloseList)等;VCB(卷控制块):代表一个已挂载的 FAT 卷;FCB/DCB/CCB:分别代表文件控制块、目录控制块与上下文控制块,共同构成打开文件的运行时状态;FAT_WINDOW:用于记录“第一个簇/最后一个簇/空闲簇数”的分配窗口结构,是 FAT 分配器的工作单位。
这套“节点类型 + 大小 + 通用头部”的模式对任何新文件系统都具有直接借鉴价值——它让驱动可以在运行时安全地判定任意内部记录的合法性与类型。
初始化与 IRP/FastIo 分发:fatinit.c
fatinit.c 实现了 DriverEntry,是理解驱动“接线方式”的核心。除了创建 \Fat 与 \FatCdrom 两个设备对象外,它集中注册了全部 IRP 主功能分发例程:
IRP_MJ_CREATE → FatFsdCreate
IRP_MJ_CLOSE → FatFsdClose
IRP_MJ_READ → FatFsdRead
IRP_MJ_WRITE → FatFsdWrite
IRP_MJ_QUERY_INFORMATION → FatFsdQueryInformation
IRP_MJ_SET_INFORMATION → FatFsdSetInformation
IRP_MJ_QUERY_EA / SET_EA → FatFsdQueryEa / FatFsdSetEa
IRP_MJ_FLUSH_BUFFERS → FatFsdFlushBuffers
IRP_MJ_QUERY_VOLUME_INFORMATION → FatFsdQueryVolumeInformation
IRP_MJ_SET_VOLUME_INFORMATION → FatFsdSetVolumeInformation
IRP_MJ_CLEANUP → FatFsdCleanup
IRP_MJ_DIRECTORY_CONTROL → FatFsdDirectoryControl
IRP_MJ_FILE_SYSTEM_CONTROL → FatFsdFileSystemControl
IRP_MJ_LOCK_CONTROL → FatFsdLockControl
IRP_MJ_DEVICE_CONTROL → FatFsdDeviceControl
IRP_MJ_SHUTDOWN → FatFsdShutdown
IRP_MJ_PNP → FatFsdPnp
这几乎是 WDM 文件系统驱动分发表的“标准答案”,新文件系统可以照此逐项填充。
同时,DriverEntry 初始化 FastIoDispatch 表(FastIoRead/FastIoWrite 复用缓存管理器的 FsRtlCopyRead/FsRtlCopyWrite,另有 MdlRead、MdlWriteComplete、FastIoLock/FastIoUnlockAll 等),注册缓存管理器的延迟写回调(AcquireForLazyWrite/ReleaseFromLazyWrite),并注册文件系统过滤器回调(FsRtlRegisterFileSystemFilterCallbacks,用于 PreAcquireForSectionSynchronization)。此外还根据系统大小(MmQuerySystemSize 返回的 Small/Medium/Large)调整延迟关闭队列深度——这一“按机器规模自适应”的细节同样值得新文件系统参考。全局数据(FAT_DATA FatData、FatFastIoDispatch、各 lookaside 列表、保留 MDL 等)在 fatdata.c 中定义。
各功能模块:IRP 处理例程的落点
分发表中的每个例程都有对应实现文件,形成“一模块一职责”的清晰布局(下表基于仓库源码实际文件整理):
| 功能域 | 实现文件 | 说明 |
|---|---|---|
| 文件创建/打开 | create.c | 处理 IRP_MJ_CREATE,包含打开卷、打开根 DCB、打开既有 DCB/FCB 等子路径,并采集 CreateHits/SuccessfulCreates/FailedCreates 性能计数 |
| 读/写 | read.c、write.c | 文件数据 I/O,与缓存管理器协作 |
| 文件/目录控制 | fileinfo.c、dirctrl.c、dirsup.c | 查询/设置文件信息、目录枚举 |
| 卷信息 | volinfo.c、fsctrl.c | 查询/设置卷信息、文件系统控制 |
| 锁控制 | lockctrl.c | 字节范围锁 |
| EA(扩展属性) | ea.c、easup.c | 查询/设置扩展属性 |
| PnP 与关机 | pnp.c、shutdown.c | 卷挂载/卸载、系统关机处理 |
| 卷验证 | verfysup.c | FatVerifyVolume、FatDeferredCleanVolume 等卷一致性验证与清理 |
| 分配管理 | allocsup.c、resrcsup.c | 簇分配与资源同步 |
| 缓存/冲排 | cachesup.c、flush.c | 缓存映射与缓冲刷新 |
| 其他支撑 | namesup.c、filobsup.c、deviosup.c、strucsup.c、splaysup.c、timesup.c、workque.c、fspdisp.c、acchksup.c、dumpsup.c | 名字解析、文件对象支撑、设备 I/O、结构支撑(splay 树)、时间戳换算、工作队列、快速 I/O 分发等 |
以 create.c 为例,其宏 CollectCreateHitStatistics/CollectCreateStatistics 展示了文件系统如何按 KeGetCurrentProcessorNumber() % FatData.NumberProcessors 索引 VCB->Statistics[] 数组来统计每次创建命中/成功/失败,这是 FILE_SYSTEM_STATISTICS 报告机制的具体实现,可作为新文件系统性能统计的范本。
写在最后:如何以 fastfat 为模型起步
总结一下把 fastfat 用作新文件系统“脚手架”的推荐路径:
- 先读磁盘格式:从 fat.h 理解 BPB、引导扇区、FSInfo 与簇链语义,再把它们替换为你自己的卷格式定义;
- 再读内存结构:对照 nodetype.h 与 fatstruc.h 的节点类型与 VCB/FCB/DCB 体系,设计新文件系统的运行时状态机;
- 以分发表为纲:参照 fatinit.c 的 IRP 主功能表与 FastIo 表,逐项实现自己的分发例程,模块划分可沿用仓库中“一文件一职责”的组织;
- 构建与迭代:使用前文给出的 Visual Studio 或
msbuild /t:clean /t:build .\fastfat.vcxproj命令持续编译验证,借助Debug|x64/Debug|ARM64配置进行调试; - 注意部署边界:由于该驱动已内置于 Windows 且无 INF,私有版本主要用于替换本机驱动做研究与教学,务必在受控环境中操作。
通过以上路径,开发者既能在短期内读懂一套真实文件系统的完整实现,也能将其中被反复验证的设计模式(节点类型体系、IRP 分发矩阵、FastIo/缓存管理器协同、按系统规模自适应的工作队列)迁移到自己的文件系统设计中去。