)
子文档一examples 目录概述与设计意图libwdi 的examples/目录是该项目为开发者提供的“活文档”与“参考实现”集合。它不仅仅是一个简单示例的堆放处而是通过两个完整的工具wdi-simple命令行工具和Zadig图形化工具以及若干辅助模块全面展示了 libwdi API 的各种使用场景和集成方式。目录结构概览examples/ ├── libusb-win32_version.h # 版本号定义供参考 ├── profile.c / profile.h # INI 风格配置文件解析器源自 Kerberos ├── wdi-simple.c # 命令行极简安装示例 ├── zadig.c # Zadig GUI 主程序 ├── zadig.h # 全局声明与辅助宏 ├── zadig_license.h # 关于对话框中的版权文本 ├── zadig_net.c # 网络更新检查模块 ├── zadig_parser.c # UTF-16 配置文件解析器 ├── zadig_registry.h # 注册表访问封装 ├── zadig_resource.h # 资源 ID 定义 ├── zadig_stdlg.c # 标准对话框关于、通知、文件夹浏览等 └── getopt/ # GNU getopt 移植命令行解析 ├── getopt.c ├── getopt.h └── getopt1.c设计意图展示 API 的完整用法wdi-simple示范了最简调用流程枚举→准备→安装而Zadig则展示了如何将 libwdi 集成到一个复杂的 GUI 应用程序中包括处理设备热插拔、进度反馈、日志显示等高级主题。提供可复用的 UI 组件zadig_stdlg.c和zadig_net.c中的代码可以作为通用 Windows GUI 编程的参考例如自定义通知对话框、带进度条的异步操作、网络下载等。解决字符串编码问题所有示例均使用 UTF-8 字符串与 libwdi API 交互并借助msapi_utf8.h位于libwdi/目录封装的 UTF-8 版本 Windows API确保在非英文系统上正确显示。提供配置文件支持profile.c和zadig_parser.c分别演示了如何使用两种不同的配置解析方式——一种是传统的 INI 风格来自 Kerberos 项目另一种是自定义的键值对解析支持 UTF-16为应用程序提供启动参数定制能力。网络更新机制zadig_net.c展示了一种轻量级的在线更新检查方案利用 WinINet 和后台线程实现无阻塞的版本检测和下载。运行模式对比特性wdi-simpleZadig用户界面命令行GUI (Win32 原生)设备选择通过命令行参数指定 VID/PID下拉列表动态选择驱动类型命令行参数指定菜单/按钮切换进度反馈控制台打印进度条 日志窗口高级功能无设备创建、WCID 支持、过滤器驱动、证书安装配置文件命令行选项zadig.ini .cfg 预设文件这两个示例覆盖了 libwdi 从入门到精通的所有层次是开发者学习和借鉴的宝贵资源。
