背景及问题：

在与硬件打交道时，经常需要知道当前设备连接的硬件信息，以便连接正确的硬件，比如串口通讯查询连接的硬件及端口，一般手工的方式就是去设备管理器查看相应的信息，应用程序如何读取这一部分信息呢，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
);

MSDN页面-SetupDiGetClassDevsW

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

WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
  [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
);

程序中设备属性设置为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）