VC++中使用WINAPI获取USB设备名称的方法

在Windows操作系统中，设备名称是与硬件设备关联的唯一标识，通常由设备的类型、生产商、型号等信息组成。当我们需要在程序中获取这些信息时，可以通过Windows API（应用程序编程接口）函数来实现。在VC++（Visual C++）环境中，使用特定的API函数来获取设备名称是一种常见的做法。 ### 使用WinAPI获取设备名称的知识点 #### 1. SetupDiGetClassDevs函数 `SetupDiGetClassDevs`函数是Windows提供的一个设备安装函数，它用于获取一个设备信息集。这个设备信息集包含了系统中特定类型或特定范围内的设备信息。在获取设备信息之前，我们需要知道设备的类GUID或者设备接口GUID。 函数原型如下： ```cpp HDEVINFO SetupDiGetClassDevs( _In_opt_ CONST GUID *ClassGuid, _In_opt_ PSTR enumerator, _In_opt_ HWND hwndParent, _In_ DWORD Flags ); ``` 其中各参数意义如下： - ClassGuid：指向设备类GUID的指针，用于获取所有该类设备的信息集。 - enumerator：指向一个字符串的指针，该字符串指定了枚举的设备接口类或设备类的名称。若为NULL，则枚举所有设备。 - hwndParent：父窗口句柄，通常用于设置设备安装向导的所有者窗口，如果不需要可以设置为NULL。 - Flags：枚举标志，指定如何枚举设备。例如DIGCF_PRESENT表示枚举当前连接的设备。 #### 2. SetupDiEnumDeviceInfo函数 `SetupDiEnumDeviceInfo`函数用于枚举一个设备信息集中的设备实例。通过循环调用该函数可以获取到设备列表。 函数原型如下： ```cpp BOOL SetupDiEnumDeviceInfo( _In_ HDEVINFO DeviceInfoSet, _In_ DWORD MemberIndex, _Out_ PSP_DEVINFO_DATA DeviceInfoData ); ``` 其中各参数意义如下： - DeviceInfoSet：由`SetupDiGetClassDevs`函数返回的设备信息集句柄。 - MemberIndex：要枚举的设备实例的索引。 - DeviceInfoData：指向SP_DEVINFO_DATA结构的指针，该结构体将接收枚举的设备信息。 #### 3. 获取设备名称 获取设备名称通常需要访问设备的属性。在调用了`SetupDiEnumDeviceInfo`之后，可以使用`SetupDiGetDeviceRegistryProperty`函数来获取设备的注册表属性，其中包括设备名称。 函数原型如下： ```cpp BOOL SetupDiGetDeviceRegistryProperty( _In_ HDEVINFO DeviceInfoSet, _In_ PSP_DEVINFO_DATA DeviceInfoData, _In_ DWORD Property, _Out_opt_ PDWORD PropertyRegDataType, _Out_ PBYTE PropertyBuffer, _Inout_opt_ DWORD PropertyBufferSize, _Out_opt_ PDWORD RequiredSize ); ``` 其中参数`Property`指定要查询的属性类型。比如`SPDRP_DEVICEDESC`用于获取设备的友好描述名称。 #### 4. VC++中的实现 在VC++中，我们需要包含`SetupAPI.h`头文件，并且链接`SetupAPI.lib`库才能使用上述函数。一个简单的示例代码如下： ```cpp #include <windows.h> #include <SetupAPI.h> #include <stdio.h> int main() { HDEVINFO hDevInfo = SetupDiGetClassDevs(NULL, NULL, NULL, DIGCF_PRESENT); if (hDevInfo == INVALID_HANDLE_VALUE) { // 错误处理 } SP_DEVINFO_DATA devInfoData; devInfoData.cbSize = sizeof(SP_DEVINFO_DATA); for (DWORD i = 0; SetupDiEnumDeviceInfo(hDevInfo, i, &devInfoData); i++) { // 可以在这里调用 SetupDiGetDeviceRegistryProperty 函数获取设备名称 } // 清理资源 SetupDiDestroyDeviceInfoList(hDevInfo); return 0; } ``` #### 5. 注意事项 - 在调用相关函数之前，需要确保应用程序具有足够的权限，否则可能无法获取到设备信息。 - 错误处理：在实际编程中，应当对`SetupDiGetClassDevs`、`SetupDiEnumDeviceInfo`、`SetupDiGetDeviceRegistryProperty`等函数的返回值进行检查，以便于问题发生时能够及时响应。 - 内存管理：使用`SetupDiDestroyDeviceInfoList`函数来释放`SetupDiGetClassDevs`分配的资源。 #### 6. 结语 以上详细介绍了通过WINAPI函数在VC++环境下获取设备名称的方法。首先通过`SetupDiGetClassDevs`函数获取设备信息集，然后使用`SetupDiEnumDeviceInfo`和`SetupDiGetDeviceRegistryProperty`函数遍历并提取所需的信息。该方法提供了强大的设备信息处理能力，适用于开发各种与硬件交互的应用程序。在实现过程中，要注意权限、错误处理和资源管理等细节，确保程序稳定运行。