windows下设备信息管理系列函数——用于设备枚举

2024-04-05 00:48

本文主要是介绍windows下设备信息管理系列函数——用于设备枚举,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

(一)SetupDiGetClassDevs

链接:https://msdn.microsoft.com/en-us/library/windows/hardware/ff551069(v=vs.85).aspx


枚举设备信息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

链接:https://msdn.microsoft.com/en-us/library/windows/hardware/ff551010(v=vs.85).aspx

 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

链接:https://msdn.microsoft.com/en-us/library/windows/hardware/ff551106(v=vs.85).aspx

The  SetupDiGetDeviceInstanceId  function retrieves the  device instance ID  that is associated with a device information element.


(四)SetupDiGetDeviceRegistryProperty

链接:https://msdn.microsoft.com/en-us/library/windows/hardware/ff551967(v=vs.85).aspx

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下设备信息管理系列函数——用于设备枚举的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/877249

相关文章

PostgreSQL中rank()窗口函数实用指南与示例

《PostgreSQL中rank()窗口函数实用指南与示例》在数据分析和数据库管理中,经常需要对数据进行排名操作,PostgreSQL提供了强大的窗口函数rank(),可以方便地对结果集中的行进行排名... 目录一、rank()函数简介二、基础示例:部门内员工薪资排名示例数据排名查询三、高级应用示例1. 每

全面掌握 SQL 中的 DATEDIFF函数及用法最佳实践

《全面掌握SQL中的DATEDIFF函数及用法最佳实践》本文解析DATEDIFF在不同数据库中的差异,强调其边界计算原理,探讨应用场景及陷阱,推荐根据需求选择TIMESTAMPDIFF或inte... 目录1. 核心概念:DATEDIFF 究竟在计算什么?2. 主流数据库中的 DATEDIFF 实现2.1

MySQL中的LENGTH()函数用法详解与实例分析

《MySQL中的LENGTH()函数用法详解与实例分析》MySQLLENGTH()函数用于计算字符串的字节长度,区别于CHAR_LENGTH()的字符长度,适用于多字节字符集(如UTF-8)的数据验证... 目录1. LENGTH()函数的基本语法2. LENGTH()函数的返回值2.1 示例1:计算字符串

MySQL 中的 CAST 函数详解及常见用法

《MySQL中的CAST函数详解及常见用法》CAST函数是MySQL中用于数据类型转换的重要函数,它允许你将一个值从一种数据类型转换为另一种数据类型,本文给大家介绍MySQL中的CAST... 目录mysql 中的 CAST 函数详解一、基本语法二、支持的数据类型三、常见用法示例1. 字符串转数字2. 数字

Python内置函数之classmethod函数使用详解

《Python内置函数之classmethod函数使用详解》:本文主要介绍Python内置函数之classmethod函数使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录1. 类方法定义与基本语法2. 类方法 vs 实例方法 vs 静态方法3. 核心特性与用法(1编程客

Python函数作用域示例详解

《Python函数作用域示例详解》本文介绍了Python中的LEGB作用域规则,详细解析了变量查找的四个层级,通过具体代码示例,展示了各层级的变量访问规则和特性,对python函数作用域相关知识感兴趣... 目录一、LEGB 规则二、作用域实例2.1 局部作用域(Local)2.2 闭包作用域(Enclos

MySQL count()聚合函数详解

《MySQLcount()聚合函数详解》MySQL中的COUNT()函数,它是SQL中最常用的聚合函数之一,用于计算表中符合特定条件的行数,本文给大家介绍MySQLcount()聚合函数,感兴趣的朋... 目录核心功能语法形式重要特性与行为如何选择使用哪种形式?总结深入剖析一下 mysql 中的 COUNT

MySQL 中 ROW_NUMBER() 函数最佳实践

《MySQL中ROW_NUMBER()函数最佳实践》MySQL中ROW_NUMBER()函数,作为窗口函数为每行分配唯一连续序号,区别于RANK()和DENSE_RANK(),特别适合分页、去重... 目录mysql 中 ROW_NUMBER() 函数详解一、基础语法二、核心特点三、典型应用场景1. 数据分

MySQL数据库的内嵌函数和联合查询实例代码

《MySQL数据库的内嵌函数和联合查询实例代码》联合查询是一种将多个查询结果组合在一起的方法,通常使用UNION、UNIONALL、INTERSECT和EXCEPT关键字,下面:本文主要介绍MyS... 目录一.数据库的内嵌函数1.1聚合函数COUNT([DISTINCT] expr)SUM([DISTIN

C++11作用域枚举(Scoped Enums)的实现示例

《C++11作用域枚举(ScopedEnums)的实现示例》枚举类型是一种非常实用的工具,C++11标准引入了作用域枚举,也称为强类型枚举,本文主要介绍了C++11作用域枚举(ScopedEnums... 目录一、引言二、传统枚举类型的局限性2.1 命名空间污染2.2 整型提升问题2.3 类型转换问题三、C