当前位置：首页 > news >正文

Qt案例通过调用Setupapi.h库实现对设备管理器中设备默认驱动的备份

news 2026/2/10 20:25:21

参考腾讯电脑管家-软件市场中的驱动备份专家写的一个驱动备份软件案例，学习Setupapi.h库中的函数使用.通过Setupapi.h库读取设备管理器中安装的设备获取安装的驱动列表，通过bit7z库备份驱动目录下的所有文件.

目录导读

- 实现效果
- 相关内容示例
- - 获取SP_DRVINFO_DETAIL_DATA结构数据
  - 相关函数
  - - SetupDiBuildDriverInfoList 函数
    - SetupDiEnumDriverInfo函数
    - SetupDiGetDriverInfoDetail 函数
  - 相关实现
  - - 获取所有驱动列表
    - 获取驱动SP_DRVINFO_DETAIL_DATA结构数据
    - qDebug打印输出 SP_DRVINFO_DETAIL_DATA 结构数据

实现效果

参考腾讯电脑管家-软件市场中的驱动备份专家软件：
在这里插入图片描述
实现对设备管理器中的驱动信息的读取和备份：

其中的驱动名称，版本信息和驱动目录都是通过设备管理器的属性获取，
详情参考以下文章内容：
Qt案例调用WINDOWS API中的SETUPAPI.H库获取设备管理器中设备的详细信息中的属性值(一)
Qt案例调用WINDOWS API中的SETUPAPI.H库获取设备管理器中设备的详细信息中的属性值(二)
驱动备份使用bit7z调用7z.exe实现相关功能,参考：
Qt 编译使用Bit7z库接口调用7z.dll、7-Zip.dll解压压缩常用Zip、ISO9660、Wim、Esd、7z等格式文件（一）

相关内容示例

遍历设备管理器中驱动程序的相关信息：

获取SP_DRVINFO_DETAIL_DATA结构数据

SP_DRVINFO_DETAIL_DATA结构包含有关特定驱动程序信息结构的详细信息。
语法

typedef struct _SP_DRVINFO_DETAIL_DATA_W {DWORD     cbSize;  //SP_DRVINFO_DETAIL_DATA结构的大小（以字节为单位）。FILETIME  InfDate; //此驱动程序的 INF 文件的日期。DWORD     CompatIDsOffset; //此值还可用于确定 CompatID 列表之前是否有 硬件 ID 。 如果此值大于 1，则 HardwareID 缓冲区中的第一个字符串是硬件 ID。 如果此值小于或等于 1，则没有硬件 ID。DWORD     CompatIDsLength; //CompatID 列表的长度（以字符为单位），从 HardwareID 缓冲区的开头偏移 CompatIDsOffset 开始。ULONG_PTR Reserved; //保留。 仅限内部使用。WCHAR     SectionName[LINE_LEN]; //一个以 NULL 结尾的字符串，包含此驱动程序的 INF DDInstall 节 的名称。 这必须是基本 DDInstall 节名称（如 InstallSec），没有任何特定于 OS/体系结构的扩展。WCHAR     InfFileName[MAX_PATH]; //一个以 NULL 结尾的字符串，其中包含此驱动程序的 INF 文件的完整限定名称。WCHAR     DrvDescription[LINE_LEN]; //一个以 NULL 结尾的字符串，用于描述驱动程序。WCHAR     HardwareID[ANYSIZE_ARRAY]; //包含 ID 列表的缓冲区 (单个 硬件 ID ，后跟 兼容 ID 列表) 。 这些 ID 对应于 INF 模型部分中的硬件 ID 和兼容 ID。列表中的每个 ID 都是以 NULL 结尾的字符串。
} SP_DRVINFO_DETAIL_DATA_W, *PSP_DRVINFO_DETAIL_DATA_W;

相关实现

获取所有驱动列表

//! QList<CONST GUID*> GUID_DEVCLASS_LIST 设备标识
for(int t=0;t<GUID_DEVCLASS_LIST.count();t++){QString IconPath=Lib_ExtrationDrives::getInstance().GeticonPath(GUID_DEVCLASS_LIST[t]);HDEVINFO deviceInfoSet = SetupDiGetClassDevs(GUID_DEVCLASS_LIST[t], NULL, NULL, DIGCF_PRESENT);if (deviceInfoSet == INVALID_HANDLE_VALUE) {printf("Failed to get device information set. Error code: %d\n", GetLastError());return ;}SP_DEVINFO_DATA deviceInfoData;deviceInfoData.cbSize = sizeof(SP_DEVINFO_DATA);for (DWORD i = 0; SetupDiEnumDeviceInfo(deviceInfoSet, i, &deviceInfoData); i++) {//SetupDiBuildDriverInfoList 函数生成与特定设备关联的驱动程序列表，或与设备信息集的全局类驱动程序列表相关联。bool ret = SetupDiBuildDriverInfoList(deviceInfoSet, &deviceInfoData, SPDIT_CLASSDRIVER);if(!ret){qDebug("Error enumerating driver info. Error code: %d\n", GetLastError());continue ;}SP_DRVINFO_DATA  rDriverInfoData;rDriverInfoData.cbSize = sizeof(SP_DRVINFO_DATA);//SetupDiEnumDriverInfo 函数枚举驱动程序列表的成员for(int j=0;SetupDiEnumDriverInfo(deviceInfoSet, &deviceInfoData, SPDIT_CLASSDRIVER, j, &rDriverInfoData);j++){PSP_DRVINFO_DETAIL_DATA rDriverInfoDetail=new SP_DRVINFO_DETAIL_DATA() ;rDriverInfoDetail->cbSize=sizeof(SP_DRVINFO_DETAIL_DATA);if(Lib_ExtrationDrives::getInstance().GetSetupDiGetDriverInfoDetail(deviceInfoSet,&deviceInfoData, &rDriverInfoData,rDriverInfoDetail)){qDebug()<<"-----"<<i<<" - "<<j;
//                    Print_DriverInfoDetail(rDriverInfoDetail);qDebug()<<"[cbSize] :"<<rDriverInfoDetail->cbSize;qDebug()<<"[SectionName] :"<<QString::fromWCharArray(rDriverInfoDetail->SectionName);//! SetupOpenInfFile 函数打开一个 INF 文件并返回它的句柄。qDebug()<<"[InfFileName] :"<<QString::fromWCharArray(rDriverInfoDetail->InfFileName);qDebug()<<"[DrvDescription] :"<<QString::fromWCharArray(rDriverInfoDetail->DrvDescription);qDebug()<<"[CompatIDsOffset] :"<<rDriverInfoDetail->CompatIDsOffset;qDebug()<<"[CompatIDsLength] :"<<rDriverInfoDetail->CompatIDsLength;}free(rDriverInfoDetail);}}SetupDiDestroyDeviceInfoList(deviceInfoSet);}

获取驱动SP_DRVINFO_DETAIL_DATA结构数据

通过SetupDiGetDriverInfoDetail函数检索SP_DRVINFO_DETAIL_DATA包含有关特定驱动程序信息结构的详细信息，预防ERROR_INSUFFICIENT_BUFFER异常

bool Lib_ExtrationDrives::GetSetupDiGetDriverInfoDetail(HDEVINFO infoset,PSP_DEVINFO_DATA device,PSP_DRVINFO_DATA  rDriver,PSP_DRVINFO_DETAIL_DATA& rDriverInfoDetail) const
{bool isSuccess=true;DWORD needSize=0;if(!SetupDiGetDriverInfoDetail(infoset,device,rDriver,rDriverInfoDetail,sizeof(SP_DRVINFO_DETAIL_DATA),&needSize)){if((GetLastError()== ERROR_INSUFFICIENT_BUFFER)){//                qDebug()<<"cbSize : "<<rDriverInfoDetail->cbSize<<" needSize : "<<needSize;rDriverInfoDetail=(SP_DRVINFO_DETAIL_DATA*)malloc(needSize);rDriverInfoDetail->cbSize = sizeof(SP_DRVINFO_DETAIL_DATA)  ;if (!SetupDiGetDriverInfoDetail(infoset, device, rDriver, rDriverInfoDetail, needSize, NULL)){isSuccess=false;qDebug()<<"Error getting detailed driver info . because needSize:"<<needSize;}}else{isSuccess=false;qDebug()<<"Error getting detailed driver info !";}}return isSuccess;
}

qDebug打印输出 SP_DRVINFO_DETAIL_DATA 结构数据

注：根据硬件 ID 和兼容 ID 列表在 INF 模型部分中的指定方式， HardwareID 缓冲区可以类似于以下任何一种：

\0
<HWID>\0
<HWID>\0<COMPATID_1>\0…<COMPATID_N>\0\0
\0<COMPATID_1>\0…<>COMPATID_N\0\0

void Print_DriverInfoDetail(PSP_DRVINFO_DETAIL_DATA rDriverInfoDetail) 
{qDebug()<<"[cbSize] :"<<rDriverInfoDetail->cbSize;qDebug()<<"[SectionName] :"<<QString::fromWCharArray(rDriverInfoDetail->SectionName);//! SetupOpenInfFile 函数打开一个 INF 文件并返回它的句柄。qDebug()<<"[InfFileName] :"<<QString::fromWCharArray(rDriverInfoDetail->InfFileName);qDebug()<<"[DrvDescription] :"<<QString::fromWCharArray(rDriverInfoDetail->DrvDescription);qDebug()<<"[CompatIDsOffset] :"<<rDriverInfoDetail->CompatIDsOffset;qDebug()<<"[CompatIDsLength] :"<<rDriverInfoDetail->CompatIDsLength;// parse the hardware ID, if it existsif (rDriverInfoDetail->CompatIDsOffset > 1){// Parse for hardware ID from index 0.// This is a single NULL-terminated stringqDebug()<<"设备的硬件 id:";//            qDebug()<<QString::fromWCharArray(rDriverInfoDetail->HardwareID);wchar_t* hardwareid=new wchar_t[MAX_PATH];int col=0;for(int i=0;i<rDriverInfoDetail->CompatIDsOffset;i++){if(rDriverInfoDetail->HardwareID[i]!='\0'){hardwareid[col]=rDriverInfoDetail->HardwareID[i];col++;}else{hardwareid[col]='\0';qDebug()<<QString::fromWCharArray(hardwareid);free(hardwareid);hardwareid=new wchar_t[MAX_PATH];col=0;}}}// Parse the compatible IDs, if they existif (rDriverInfoDetail->CompatIDsLength > 0){qDebug()<<"设备的兼容 id:";// Parse for list of compatible IDs from CompatIDsOffset.// This is a double NULL-terminated list of strings (i.e. MULTI-SZ)wchar_t* compatibleid=new wchar_t[MAX_PATH];int col=0;int lengths=rDriverInfoDetail->CompatIDsOffset+rDriverInfoDetail->CompatIDsLength;for(int i=rDriverInfoDetail->CompatIDsOffset;i<lengths;i++){if(rDriverInfoDetail->HardwareID[i]!='\0'){compatibleid[col]=rDriverInfoDetail->HardwareID[i];col++;}else{compatibleid[col]='\0';qDebug()<<QString::fromWCharArray(compatibleid);free(compatibleid);if(i+1<lengths &&(rDriverInfoDetail->HardwareID[i+1]=='\0')) //结束break;compatibleid=new wchar_t[MAX_PATH];col=0;}}}qDebug()<<endl;}

目录导读

实现效果

相关内容示例

获取SP_DRVINFO_DETAIL_DATA结构数据

相关函数

SetupDiBuildDriverInfoList 函数

SetupDiEnumDriverInfo函数

SetupDiGetDriverInfoDetail 函数

相关实现

获取所有驱动列表

获取驱动SP_DRVINFO_DETAIL_DATA结构数据

qDebug打印输出 SP_DRVINFO_DETAIL_DATA 结构数据

相关文章：