Windows 驱动实例分析系列：libwdi 驱动分析 - examples 篇(五)

子文档五Zadig 网络更新与配置解析模块Zadig 支持自动检查更新该功能由zadig_net.c和zadig_parser.c两个模块共同实现。本节将深入分析这两个模块的实现细节。网络更新检查模块zadig_net.c1. 网络连接检测GetInternetSession函数首先通过INetworkListManagerCOM 接口检测系统是否连接到互联网调用get_IsConnectedToInternet。若 COM 接口不可用或检测失败则回退到InternetGetConnectedStateAPI。如果检测到未连接函数直接返回 NULL避免后续无谓的网络请求。2. 版本文件下载DownloadFile函数实现了 HTTP 文件下载功能其步骤包括使用InternetOpen打开会话设置用户代理字符串包含应用程序名称和版本。使用InternetCrackUrl解析 URL提取主机名、端口和路径。使用InternetConnect建立连接然后HttpOpenRequest打开请求句柄。发送请求并检查 HTTP 状态码必须为 200。通过HttpQueryInfo获取内容长度创建本地文件。循环调用InternetReadFile读取数据块写入本地文件并通过进度条控件若提供更新进度。完成后关闭所有句柄。该函数支持同步下载并提供了超时设置NET_SESSION_TIMEOUT防止网络阻塞导致 UI 冻结。3. 后台检查更新线程CheckForUpdatesThread是一个独立的后台线程执行实际的更新检查逻辑首先从注册表读取上次检查时间和检查间隔若未到下次检查时间则直接退出除非强制检查。构造版本文件 URLhttps://zadig.akeo.ie/app_arch_os_major.os_minor.ver并尝试逐步降低 OS 版本号例如6.2→6以兼容旧版本系统。使用InternetOpen等函数下载版本文件格式为键值对如version2.9.788。调用parse_update解析文件内容填充APPLICATION_UPDATE结构体。比较本地版本与远程版本若远程版本更高且满足最低平台要求则触发下载新版本。该线程设计为在后台静默运行不会阻塞 UI。若检测到新版本它会等待当前安装操作结束后才弹出下载对话框避免干扰用户正在进行的操作。4. WinINet 错误处理WinInetErrorString函数将 WinINet 错误码转换为可读的字符串覆盖了从ERROR_INTERNET_OUT_OF_HANDLES到ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY等数十种错误便于调试和用户反馈。配置解析模块zadig_parser.c1. UTF-16 配置文件解析器zadig_parser.c实现了一个轻量级的配置文件解析器专门用于处理 UTF-16 编码的键值对文件例如 Zadig 的设备预设文件.cfg。其核心函数get_token_data_line从一行文本中解析token data格式的数据支持引号包裹的值并处理转义字符如\n、\t等。2. 文件解析get_token_data_file使用_wfopen以 Unicode 模式打开文件自动识别 BOM逐行读取并调用get_token_data_line查找匹配的令牌。若找到将值转换为 UTF-8 并返回。3. 缓冲区解析get_token_data_buffer用于解析内存中的 UTF-8 字符串如从网络下载的版本文件。它首先将整个缓冲区转换为 UTF-16然后逐行处理并支持跳过大括号包裹的多行内容用于 RTF 等复杂格式。4. 更新数据解析parse_update专门用于解析更新版本文件。它首先对缓冲区进行“清洗”仅允许安全字符字母、数字、空格、标点等防止注入攻击。然后依次提取version、platform_min、download_url和release_notes字段并填充APPLICATION_UPDATE结构体。5. 预设配置文件加载Zadig 支持通过菜单“打开”加载.cfg文件该文件可包含设备 VID、PID、描述、MI、GUID 等预设值。parse_preset函数调用profile_open来自profile.c解析 INI 风格的配置文件并将读取到的值填充到 UI 控件中方便用户快速配置特定设备。注册表配置存储zadig_registry.h提供了一组内联函数用于读写注册表中 Zadig 的配置项如更新检查间隔、是否包含测试版、上次检查时间等。这些函数封装了RegOpenKeyEx、RegCreateKeyEx、RegQueryValueEx、RegSetValueEx等底层操作并支持 32 位/64 位整数、字符串和布尔值。注册表根键为HKEY_CURRENT_USER\Software\Akeo Consulting\Zadig所有用户设置存储在此无需管理员权限。