易语言调用Windows API安装驱动详解

一、驱动安装的几种方式对比

在Windows系统中安装驱动程序有多种方法，对于易语言开发者来说，了解每种方式的优缺点很重要：

常见驱动安装方式：

设备管理器手动安装 - 适合普通用户，不适合程序自动化
Setup.exe安装程序 - 厂商提供的标准方式
命令行工具安装 - 适合批量部署
Windows API编程安装 - 最适合软件集成，自动化程度高

今天重点讲解的就是第4种方式，通过易语言调用Windows API实现驱动安装。

二、核心API函数解析

2.1 主要使用的API函数

.DLL命令 UpdateDriverForPlugAndPlayDevices, 逻辑型, "newdev.dll"
    .参数 hwndParent, 整数型
    .参数 HardwareId, 文本型
    .参数 FullInfPath, 文本型
    .参数 InstallFlags, 整数型
    .参数 bRebootRequired, 逻辑型型, 传址

这个函数是驱动安装的核心，它专门用于即插即用设备的驱动安装。

参数详细说明：

hwndParent：父窗口句柄，可以填0
HardwareId：硬件ID，这是识别设备的关键
FullInfPath：INF文件的完整路径
InstallFlags：安装标志，控制安装行为
bRebootRequired：传出参数，告诉是否需要重启

2.2 辅助API函数

.DLL命令 SetupCopyOEMInf, 整数型, "setupapi.dll"
    .参数 SourceInfFileName, 文本型
    .参数 OEMSourceMediaLocation, 文本型
    .参数 OEMSourceMediaType, 整数型
    .参数 CopyStyle, 整数型
    .参数 DestinationInfFileName, 文本型
    .参数 DestinationInfFileNameSize, 整数型
    .参数 RequiredSize, 整数型型, 传址
    .参数 DestinationInfFileNameComponent, 文本型型, 传址

这个函数用于将INF文件复制到系统目录，是安装前的必要步骤。

三、完整安装流程步骤

步骤1：准备工作

首先，你需要准备好以下文件：

驱动文件（.sys文件）
INF安装信息文件
相关的CAT签名文件（如果驱动有签名）

把这些文件放在同一个文件夹中，比如：C:\MyDriver\

步骤2：获取硬件ID

硬件ID是设备的"身份证"，获取方法：

打开设备管理器
找到目标设备，右键选择"属性"
切换到"详细信息"选项卡
在下拉菜单中选择"硬件ID"
复制第一个值，通常是PCI\VEN_XXXX&DEV_XXXX格式

步骤3：易语言完整代码示例

下面是一个完整的易语言驱动安装程序：

.版本 2
.程序集 窗口程序集_启动窗口
.程序集变量 硬件ID, 文本型
.程序集变量 INF路径, 文本型

.子程序 __启动窗口_创建完毕
    硬件ID ＝ "USB\VID_1234&PID_5678"  ' 这里替换成你的硬件ID
    INF路径 ＝ "C:\MyDriver\mydriver.inf"  ' INF文件完整路径

.子程序 _按钮_安装_被单击
    .局部变量 需要重启, 逻辑型
    .局部变量 安装结果, 逻辑型

    ' 第一步：复制INF文件到系统目录
    复制INF到系统目录 (INF路径)

    ' 第二步：安装驱动
    安装结果 ＝ 安装驱动程序 (硬件ID, INF路径, 需要重启)

    .如果 (安装结果)
        信息框 (“驱动安装成功！”, 0, , )
        .如果 (需要重启)
            信息框 (“需要重启电脑才能使驱动生效”, 0, , )
        .如果结束
    .否则
        信息框 (“驱动安装失败，请检查：” ＋ #换行符 ＋ 
               “1. INF文件路径是否正确” ＋ #换行符 ＋
               “2. 硬件ID是否正确” ＋ #换行符 ＋
               “3. 是否有管理员权限”, 0, , )
    .如果结束

.子程序 复制INF到系统目录, 逻辑型
    .参数 INF源路径, 文本型
    .局部变量 结果, 整数型

    结果 ＝ SetupCopyOEMInf (INF源路径, 取文本左边 (INF源路径, 倒找文本 (INF源路径, "\", , 假)), 
                           0, 1, "", 0, 0, "")

    返回 (结果 ≠ 0)

.子程序 安装驱动程序, 逻辑型
    .参数 硬件ID, 文本型
    .参数 INF路径, 文本型
    .参数 需要重启, 逻辑型, 参考
    .局部变量 安装标志, 整数型

    ' 设置安装标志
    ' 0x00000001 - 仅安装，不搜索Windows Update
    ' 0x00000002 - 信任INF文件
    安装标志 ＝ 位或 (1, 2)

    返回 (UpdateDriverForPlugAndPlayDevices (0, 硬件ID, INF路径, 安装标志, 需要重启))

四、常见问题与解决方案

4.1 权限不足问题

问题现象： 安装失败，错误代码5（拒绝访问）

解决方案：

以管理员身份运行易语言开发环境
编译后的程序右键选择"以管理员身份运行"
或者在程序开头添加UAC提权代码

.如果真 (是否已管理员身份运行 () ＝ 假)
    运行 (“cmd /c echo Set UAC = CreateObject^("Shell.Application"^) > ” ＋ 取临时文件名 () ＋ “.vbs”, 真, )
    运行 (“cmd /c echo UAC.ShellExecute ” ＋ #引号 ＋ 取执行文件名 () ＋ #引号 ＋ “, ” ＋ #引号 ＋ #引号 ＋ “, ” ＋ #引号 ＋ #引号 ＋ “, ” ＋ #引号 ＋ “runas” ＋ #引号 ＋ “ >> ” ＋ 取临时文件名 () ＋ “.vbs”, 真, )
    运行 (取临时文件名 () ＋ “.vbs”, 假, )
    结束 ()
.如果真结束

4.2 驱动签名问题

问题现象： Windows提示"无法验证此驱动程序软件的发布者"

解决方案：

临时方案：在高级启动选项中禁用驱动签名强制（不推荐生产环境）
正式方案：购买代码签名证书对驱动进行签名
测试方案：使用测试签名（仅用于开发和测试）

4.3 INF文件格式问题

一个正确的INF文件结构示例：

[Version]
Signature="$WINDOWS NT$"
Class=Sample
ClassGuid={78A1C341-4539-11d3-B88D-00C04FAD5171}
Provider=%Manufacturer%
DriverVer=01/01/2023,1.0.0.0

[Manufacturer]
%Manufacturer%=Standard,NTamd64

[Standard.NTamd64]
%DeviceName%=DriverInstall, USB\VID_1234&PID_5678

[DriverInstall.NT]
CopyFiles=Drivers_Dir

[Drivers_Dir]
mydriver.sys

[SourceDisksNames]
1 = %DiskName%,,,

[SourceDisksFiles]
mydriver.sys = 1,,

[Strings]
Manufacturer="Your Company"
DeviceName="Your Device"
DiskName="Your Driver Disk"

五、进阶技巧与优化

5.1 静默安装实现

对于需要批量部署的场景，可以完全无界面安装：

.子程序 静默安装驱动
    .参数 硬件ID, 文本型
    .参数 INF路径, 文本型

    .局部变量 需要重启, 逻辑型
    .局部变量 安装标志, 整数型

    安装标志 ＝ 位或 (1, 2, 4)  ' 4表示静默安装

    UpdateDriverForPlugAndPlayDevices (0, 硬件ID, INF路径, 安装标志, 需要重启)

5.2 驱动卸载功能

安装后可能还需要卸载功能：

.DLL命令 DiUninstallDriver, 逻辑型, "newdev.dll"
    .参数 hwndParent, 整数型
    .参数 InfPath, 文本型
    .参数 Flags, 整数型
    .参数 NeedReboot, 逻辑型型, 传址

.子程序 卸载驱动
    .参数 INF路径, 文本型

    .局部变量 需要重启, 逻辑型

    DiUninstallDriver (0, INF路径, 1, 需要重启)

    .如果 (需要重启)
        信息框 (“需要重启完成卸载”, 0, , )
    .如果结束

5.3 错误处理增强

完善的错误处理能让程序更稳定：

.子程序 安全安装驱动, 逻辑型
    .参数 硬件ID, 文本型
    .参数 INF路径, 文本型

    .局部变量 错误代码, 整数型
    .局部变量 需要重启, 逻辑型

    .如果真 (文件是否存在 (INF路径) ＝ 假)
        信息框 (“INF文件不存在：” ＋ INF路径, 16, , )
        返回 (假)
    .如果真结束

    .如果真 (UpdateDriverForPlugAndPlayDevices (0, 硬件ID, INF路径, 3, 需要重启) ＝ 假)
        错误代码 ＝ GetLastError ()

        .判断开始 (错误代码 ＝ 2)
            信息框 (“文件未找到，请检查路径”, 16, , )
        .判断 (错误代码 ＝ 5)
            信息框 (“权限不足，请以管理员身份运行”, 16, , )
        .判断 (错误代码 ＝ 0xE000024B)
            信息框 (“驱动签名验证失败”, 16, , )
        .默认
            信息框 (“安装失败，错误代码：” ＋ 到文本 (错误代码), 16, , )
        .判断结束

        返回 (假)
    .如果真结束

    返回 (真)