Windows下获取设备管理器列表信息-setupAPI

背景及问题:

在与硬件打交道时,经常需要知道当前设备连接的硬件信息,以便连接正确的硬件,比如串口通讯查询连接的硬件及端口,一般手工的方式就是去设备管理器查看相应的信息,应用程序如何读取这一部分信息呢,Windows下的SetupAPI系列就可以解决这个问题

示例程序

#include<Windows.h>
#include<SetupAPI.h>
#include<iostream>
#include<string>
#pragma comment(lib, "setupapi.lib")

int main()
{
	//set chinese character
	std::locale::global(std::locale(""));

	//The SetupDiGetClassDevs function returns a handle to a device 
    //information set that contains requested device information 
    //elements for a local computer.
	HDEVINFO hdevinfo = SetupDiGetClassDevs(NULL,
		NULL, NULL, DIGCF_PRESENT | DIGCF_ALLCLASSES);
	if (hdevinfo != INVALID_HANDLE_VALUE)
	{
		DWORD MemberIndex = 0;
		SP_DEVINFO_DATA sp_devinfo_data;
		ZeroMemory(&sp_devinfo_data, sizeof(sp_devinfo_data));
		sp_devinfo_data.cbSize = sizeof(sp_devinfo_data);

        //The SetupDiEnumDeviceInfo function returns a SP_DEVINFO_DATA 
        //structure that specifies a device information element in a 
        //device information set.
		while (SetupDiEnumDeviceInfo(hdevinfo, MemberIndex, &sp_devinfo_data))
		{
			TCHAR PropertyBuffer[100];

        	//The SetupDiGetDeviceRegistryProperty function retrieves
			//a specified Plug and Play device property.    
			if (SetupDiGetDeviceRegistryProperty(hdevinfo,
				&sp_devinfo_data,
				SPDRP_DEVICEDESC,
				NULL,
				(PBYTE)&PropertyBuffer,
				sizeof(PropertyBuffer),
				NULL))
			{

				std::wcout << MemberIndex << ":" << (wchar_t*)PropertyBuffer << std::endl;

			}
			MemberIndex++;

		}

	}
	return 0;
}

解释

主要是3个API的使用
  1. SetupDiGetClassDevs -->获取设备信息的集合
  2. SetupDiEnumDeviceInfo -->针对具体的设备解析信息
  3. SetupDiGetDeviceRegistryProperty -->提取具体设备的感兴趣信息

其中SetupDiGetClassDevs定义如下

WINSETUPAPI HDEVINFO SetupDiGetClassDevsW(
  [in, optional] const GUID *ClassGuid,
  [in, optional] PCWSTR     Enumerator,
  [in, optional] HWND       hwndParent,
  [in]           DWORD      Flags
);
Parameter Description
[in, optional]const GUID *ClassGuid 指向设备设置类或设备接口GUID的指针。可为NULL(可选)
[in, optional] PCWSTR Enumerator 指定设备种类。可为NULL(可选)
[in, optional] HWND hwndParent 显示设备信息UI界面窗口句柄。可为NULL(可选)
[in, optional] DWORD Flags 过滤设备信息标志位
返回值HDEVINFO 返回设备信息的集合
程序中前三个均设置为NULL,第四个标志位设为DIGCF_PRESENT|DIGCF_ALLCLASSES,表示当前系统已安装的所有设备,还有一些标志参见

MSDN页面-SetupDiGetClassDevsW

拿到设备信息集合之后,使用SetupDiEnumDeviceInfo进行单个设备信息的解析

WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
  [in]  HDEVINFO         DeviceInfoSet,
  [in]  DWORD            MemberIndex,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter Description
[in] HDEVINFO DeviceInfoSet 设备信息集合句柄
[in] DWORD MemberIndex 集合中第几个设备
[out] PSP_DEVINFO_DATA DeviceInfoData 具体的设备信息数据
拿到单个设备的信息之后(仍包含很多信息),使用SetupDiGetDeviceRegistryProperty对感兴趣的信息解析
WINSETUPAPI BOOL SetupDiGetDeviceRegistryPropertyW(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [in]            DWORD            Property,
  [out, optional] PDWORD           PropertyRegDataType,
  [out, optional] PBYTE            PropertyBuffer,
  [in]            DWORD            PropertyBufferSize,
  [out, optional] PDWORD           RequiredSize
);
Parameter Description
[in] HDEVINFO 设备信息集合句柄
[in] PSP_DEVINFO_DATA DeviceInfoData 具体的设备信息数据
[in] DWORD Property 设备属性
[out, optional] PDWORD PropertyRegDataType 指向接收所检索属性的数据类型变量的指针。可为NULL(可选)
[out, optional] PBYTE PropertyBuffer 指向接收正在检索的属性的缓冲区的指针
[in] DWORD PropertyBufferSize 缓冲区大小
[out, optional] PDWORD RequiredSize 缓冲区的所需大小。可为NULL(可选)
程序中设备属性设置为SPDRP_DEVICEDESC,查询的是设备名的描述,还有很多属性参见

MSDN页面-SetupDiGetDeviceRegistryPropertyW

需要注意的是

  • windows API 通常分单双字节版本,单字节版本一般调用A结尾的API,对应的VS项目属性中字符集为Multi-Byte,双字节版本一般调用以w结尾的API,对应VS项目属性中字符集为Unicode。本例项目属性为Unicode,对应双字节字符串版本,所以输出信息以wcout输出,缓冲区指针转换为wchar_t*
  • TCHAR为自动根据项目中字符集属性转为char(Multi-Byte)或wchar(Unicode)