本文主要是介绍windows下设备信息管理系列函数——用于设备枚举,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
(一)SetupDiGetClassDevs
枚举设备信息SetupDiGetClassDevs:获取一个指定类别或全部类别的所有已安装设备的信息
HDEVINFO SetupDiGetClassDevs(
IN PGUID ClassGuid,
IN PCTSTR Enumerator,
IN HWND hwndParent,
IN DWORD Flags
);
参数说明:
ClassGuid:一个特定类别GUID(需要查询注册表)的指针;如果设置了DIGCF_ALLCLASSES标记,该参数备忽略,将返回所有类别的设备信息表
Enumerator:过滤枚举的内容:如:PCI则只显示PCI设备,
hwndParent:用于关联到集合成员中的用户接口的顶层窗口句柄
Flags:建立设备信息表的控制选项,可以是下列值
l DIGCF_PRESENT:只列出当前存在的设备信息
l DIGCF_ALLCLASSES:列出所有类别的一安装的设备表,如果设置了此值,则指定的类别将备忽略
l DIGCF_PROFILE:只返回当前硬件概况部分
返回值:
如成功,返回包含所有与指定参数匹配的已经安装设备信息句柄
如失败则返回INVALID_HANDLE_VALUE
(二)SetupDiEnumDeviceInfo
SetupDiEnumDeviceInfo:枚举指定设备信息集合的成员,并将数据放在PSP_DEVINFO_DATA中
BOOLEAN SetupDiEnumDeviceInfo(
IN HDEVINFO DeviceInfoSet,
IN DWORD MemberIndex,
OUT PSP_DEVINFO_DATA DeviceInfoData
);
参数说明:
DeviceInfoSet:提供一个设备信息集合的句柄
MemberIndex:指定一个要取得的设备信息成员序号,从0开始
DeviceInfoData:指向SP_DEVINFO_DATA结构的指针,关于指定成员的返回信息就放在该结构中
返回值:
成功返回True,否则返回False)
使用说明:如果要枚举全部设备信息成员,装载者首先应该将MemberIndex设为0调用SetupDiEnumDeviceInfo,然后递增MemberIndex(使用一个for循环),调用SetupDiEnumDeviceInfo,直至所有成员全部遍历(此时函数返回False,并且GetLastError返回ERROR_NO_MORE_ITEMS)
(三)SetupDiGetDeviceInstanceId
(四)SetupDiGetDeviceRegistryProperty
SetupDiGetDeviceRegistryProperty:获得单个装置的详细资料
WINSETUPAPIBOOL WINAPI
SetupDiGetDeviceRegistryProperty(
IN HDEVINFO DeviceInfoSet,
IN PSP_DEVINFO_DATA DeviceInfoData,
IN DWORD Property,
OUT PDWORD PropertyRegDataType,OPTIONAL
OUT PBYTE PropertyBuffer,
IN DWORD PropertyBufferSize,
OUT PDWORD RequiredSize OPTIONAL
);
参数说明:
DeviceInfoSet:设备信息句柄
DeviceInfoData:SP_DEVINFO_DATA结构体,包含DeviceInfoSet 中的设备信息
Property:
取以下的值:
SPDRP_ADDRESS:查询设备的地址
SPDRP_BUSNUMBER:查询设备的bus号
SPDRP_BUSTYPEGUID:查询设备的GUID号
SPDRP_CAPABILITIES
(五)SetupDiDestroyDeviceInfoList
链接:https://msdn.microsoft.com/en-us/library/windows/hardware/ff550996(v=vs.85).aspx
The SetupDiDestroyDeviceInfoList 销毁一个设备信息集合,并且释放所有关联的内存
BOOL SetupDiDestroyDeviceInfoList( HDEVINFO DeviceInfoSet );
Paremeter:
DeviceInfoSet
[in]要释放的设备信息句柄
ReturnValue:
成功返回非零,否则返回零
枚举实例
int CUsbVcpDev::FindDevices(void)
{HDEVINFO hDevInfo = INVALID_HANDLE_VALUE;SP_DEVINFO_DATA spDevInfoData;PSP_DEVICE_INTERFACE_DETAIL_DATA DevDetail = NULL;int DevCount = 0;int Index;TCHAR szBuf[MAX_PATH];BOOL ok;QString strDevName;QString strFriendlyName;QString strDeviceDesc;QString strPid;QString strVid;QString strDevPath;QString strPortName;spDevInfoData.cbSize = sizeof(SP_DEVINFO_DATA);m_strDevPath.clear();/*Format the pid and vid*/strVid.sprintf(("VID_%04X"), m_vid);strPid.sprintf(("PID_%04X"), m_pid);// GUID_DEVINTERFACE_USB_DEVICEGUID usb_guid = { 0xA5DCBF10, 0x6530, 0x11D2, { 0x90, 0x1F, 0x00, 0xC0, 0x4F, 0xB9, 0x51, 0xED }};/* Get Device Information for all present devices */hDevInfo = SetupDiGetClassDevs(&usb_guid, NULL, NULL, DIGCF_PRESENT | DIGCF_ALLCLASSES/*|DIGCF_DEVICEINTERFACE*//*|DIGCF_ALLCLASSES*/);if (hDevInfo == INVALID_HANDLE_VALUE){SetupDiDestroyDeviceInfoList(hDevInfo);return 0;}//A zero-based index into the list of interfaces in the device information set.//The caller should call this function first with MemberIndex set to zero to obtain//the first interface. Then, repeatedly increment MemberIndex and retrieve an//interface until this function fails and GetLastError returns ERROR_NO_MORE_ITEMS.Index = -1;/* Scan all Devices */while (1){Index++;ok = SetupDiEnumDeviceInfo(hDevInfo, Index, &spDevInfoData);if (!ok){break;}//get instanceID such as "USB\VID_0483&PID_5740\48EB81653230"ok = SetupDiGetDeviceInstanceId(hDevInfo,&spDevInfoData,szBuf,MAX_PATH,NULL);if (!ok){break;}strDevName = QString::fromWCharArray(szBuf);strDevName.toUpper();/*check the idProduct and idVendor are match or not*/if ((strDevName.indexOf(("USB")) != 0)|| (strDevName.indexOf(strVid) != 4)|| (strDevName.indexOf(strPid) != 13)){/*not a usb device or pid & vid is not match*/continue;}/*get device name such as "STMicroelectronics Virtual COM Port"*/ok = SetupDiGetDeviceRegistryProperty(hDevInfo,&spDevInfoData,SPDRP_DEVICEDESC,NULL,(PBYTE)szBuf,MAX_PATH,NULL);if (!ok){break;}/*get device desc*/strDeviceDesc = QString::fromWCharArray(szBuf);//get device friendly name such as "STMicroelectronics Virtual COM Port (COM13)"ok = SetupDiGetDeviceRegistryProperty(hDevInfo,&spDevInfoData,SPDRP_FRIENDLYNAME,NULL,(PBYTE)szBuf,MAX_PATH,NULL);if (!ok){break;}/*get device friendly name*/strFriendlyName = QString::fromWCharArray(szBuf);/*remove device descrition*/strPortName = strFriendlyName.right(strFriendlyName.length() - strDeviceDesc.length());/*the com name is between '(' and ')'*/int sIndex = strPortName.indexOf(("(")) + 1;int eIndex = strPortName.indexOf((")")) ;strPortName = strPortName.mid(sIndex, eIndex - sIndex);strDevPath =("\\\\.\\") + strPortName;m_strDevPath = strDevPath;m_strDeviceDesc = strFriendlyName;//strDeviceDesc;DevCount++;}
这篇关于windows下设备信息管理系列函数——用于设备枚举的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!