子文档一libwdi 核心库概述与整体架构libwdi 的核心库代码位于libwdi/目录下这是整个项目的功能主体。该目录包含约 20 个 C 源文件和头文件共同构成了一个自包含的 Windows USB 驱动安装库。与examples/目录中的示例程序不同核心库不依赖任何外部资源所有必需的驱动二进制、模板文件、安装器可执行文件均以二进制数组的形式嵌入到库中。目录结构解析libwdi/ ├── libwdi.h # 对外 API 声明公共接口 ├── libwdi.c # 主要 API 实现设备枚举、驱动准备、安装调度 ├── libwdi_i.h # 内部头文件私有数据结构、函数声明 ├── libwdi_dlg.c # 进度条对话框实现GUI 模式安装 ├── embedder.c # 资源嵌入工具构建时生成 embedded.h ├── embedder.h # 嵌入工具配置宏 ├── embedder_files.h # 需要嵌入的文件清单 ├── installer.c # 提权安装器主程序独立进程 ├── installer.h # 安装器内部头文件管道协议、辅助宏 ├── tokenizer.c # 令牌替换引擎用于 INF/CAT 模板 ├── tokenizer.h # 令牌引擎接口 ├── pki.c # PKI 模块证书创建、CAT 签名、自签名 ├── mssign32.h # MSSign32 API 声明代码签名 ├── logging.c # 日志系统管道 窗口消息 ├── logging.h # 日志接口宏 ├── vid_data.c # USB VID 厂商名称数据库自动生成 ├── msapi_utf8.h # UTF-8 版本 Windows API 封装 ├── stdfn.h # 通用辅助宏与函数 ├── resource.h # 资源 ID用于进度条对话框 ├── config.h # 编译配置由 msvc/config.h 或 configure 生成 └── embedded.h # 由 embedder 生成包含所有嵌入资源数据设计分层核心库采用三层架构资源层embedder在构建时将各类文件驱动 .sys/.dll、INF 模板、CAT 模板、安装器 .exe转换为 C 数组生成embedded.h。vid_data.c提供了 VID 到厂商名称的静态映射表。逻辑层libwdi.c实现对外 API协调各子模块完成设备枚举、驱动准备和安装。tokenizer.c提供模板替换能力用于动态生成 INF 和 CAT 文件内容。pki.c实现自签名证书的创建、安装、CAT 文件生成和签名。installer.c作为独立进程处理实际的驱动安装操作需管理员权限。libwdi_dlg.c提供带进度条的模态对话框用于在 GUI 应用中显示安装进度。适配层msapi_utf8.h将所有 Windows API 封装为 UTF-8 版本使核心代码统一使用 UTF-8 编码。logging.c提供跨进程日志收集和分发机制。stdfn.h提供安全字符串操作、注册表读写等通用功能。模块间协作关系libwdi.c是总控制器它调用tokenizer生成 INF调用pki生成 CAT然后通过installer执行实际安装。installer.c是一个独立的可执行文件通过命名管道与libwdi.c通信获取设备信息并回传日志和状态。logging.c提供独立的日志管道用于将内部日志实时传递给注册的窗口如 Zadig 的日志窗口。libwdi_dlg.c仅在wdi_install_driver被调用且传入了hWnd时激活它会创建一个进度对话框并在后台线程中执行安装逻辑。这种设计使得 libwdi 既可以用于控制台应用无 UI也可以无缝集成到图形界面中同时保证了权限隔离普通用户权限与管理员权限分离和资源自包含。