深入解析 Windows fastfat 文件系统驱动示例:以 FAT 为蓝本构建新文件系统

原创2026-09-26 12:18:231,946 阅读
文章标签:示例工程驱动开发操作系统硬件开发

深入解析 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,并结合仓库配置补充说明):

  1. 在 Visual Studio 中打开 fastfat.sln(或直接打开 fastfat.vcxproj 项目文件);
  2. 在解决方案资源管理器中右键解决方案,选择配置管理器;
  3. 在配置管理器中选择与目标构建对应的活动解决方案配置(Debug 或 Release)与活动解决方案平台(x64 或 ARM64);
  4. 从生成菜单点击生成解决方案(快捷键 Ctrl+Shift+B)。

提示:当你基于 Windows 驱动模板新建驱动项目,或从旧版 WDK 源码转换项目时,Visual Studio 的转换过程会保留目标版本信息(操作系统与平台)。因此从既有 WDK 代码迁移到本示例的工程结构,目标平台信息不会丢失。

方式二:使用命令行(MSBuild)构建

旧版 WDK 使用 Build.exe 并为每种构建配置提供独立的构建环境窗口;现在则统一使用 Visual Studio 命令提示符中的 MSBuild.exe 完成所有配置的构建。

步骤(摘自 README,命令已针对仓库实际项目名校正):

  1. 从开始屏幕打开一个 Visual Studio 命令提示符窗口(此窗口环境中可找到 MsBuild.exe);
  2. 进入项目目录,对目标项目执行 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 指出:你可以构建该文件系统的私有版本,并把它作为本机原生驱动的替换品使用。这意味着典型的使用场景是:

  1. 修改源码(例如为学习或实验目的加入自己的逻辑);
  2. 构建出私有版 fastfat.sys;
  3. 用其替换 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 用作新文件系统“脚手架”的推荐路径:

  1. 先读磁盘格式:从 fat.h 理解 BPB、引导扇区、FSInfo 与簇链语义,再把它们替换为你自己的卷格式定义;
  2. 再读内存结构:对照 nodetype.h 与 fatstruc.h 的节点类型与 VCB/FCB/DCB 体系,设计新文件系统的运行时状态机;
  3. 以分发表为纲:参照 fatinit.c 的 IRP 主功能表与 FastIo 表,逐项实现自己的分发例程,模块划分可沿用仓库中“一文件一职责”的组织;
  4. 构建与迭代:使用前文给出的 Visual Studio 或 msbuild /t:clean /t:build .\fastfat.vcxproj 命令持续编译验证,借助 Debug|x64/Debug|ARM64 配置进行调试;
  5. 注意部署边界:由于该驱动已内置于 Windows 且无 INF,私有版本主要用于替换本机驱动做研究与教学,务必在受控环境中操作。

通过以上路径,开发者既能在短期内读懂一套真实文件系统的完整实现,也能将其中被反复验证的设计模式(节点类型体系、IRP 分发矩阵、FastIo/缓存管理器协同、按系统规模自适应的工作队列)迁移到自己的文件系统设计中去。

登录后查看全文
Windows-driver-samples