详解setupdienumdeviceinfo函数

一、概述

setupdienumdeviceinfo是Windows API中的一个函数，它用于列举指定设备实例安装的设备信息集，可以用于获取设备的属性、配置、驱动程序等信息。

二、函数结构和语法

函数语法如下：

BOOL SetupDiEnumDeviceInfo(
  HDEVINFO         DeviceInfoSet,
  DWORD            MemberIndex,
  PSP_DEVINFO_DATA DeviceInfoData
);

参数：

• DeviceInfoSet: 设备信息集的句柄。
• MemberIndex: 指定要枚举的设备信息集中的设备序号，从0开始。
• DeviceInfoData: 指向 SP_DEVINFO_DATA 结构体的指针，用于返回设备信息。

三、详解

1. 如何获得DeviceInfoSet

调用SetupDiGetClassDevs函数获取指定设备的信息集合句柄。例如，下面的代码获取所有驱动程序的信息集：

HDEVINFO hDevInfo = SetupDiGetClassDevs(NULL,  //类名
                                        NULL,  //枚举器
                                        NULL,  //hwndParent
                                        DIGCF_ALLCLASSES | DIGCF_PRESENT);  //设备信息类别

2. 获取设备信息

使用SetupDiEnumDeviceInfo枚举每个项目，并使用DeviceInfoData参数存储设备信息。

SP_DEVINFO_DATA DeviceInfoData;
DeviceInfoData.cbSize = sizeof(SP_DEVINFO_DATA);

for (DWORD Index = 0; SetupDiEnumDeviceInfo(hDevInfo, Index, &DeviceInfoData); Index++)
{
    // 获取设备信息
}

3. 操作设备信息

可以使用 SetupDiGetDeviceRegistryProperty 函数获取设备的注册表属性。例如，下面的代码获取设备名称：

TCHAR buffer[MAX_PATH];
DWORD buffersize = sizeof(buffer);

if (SetupDiGetDeviceRegistryProperty(hDevInfo, &DeviceInfoData, SPDRP_DEVICEDESC, NULL, (PBYTE)buffer, buffersize, NULL))
{
    // 打印设备名称
    wprintf(L"Device Name: %s\n", buffer);
}

四、小结

使用setupdienumdeviceinfo函数，我们可以获取某台电脑上的设备信息，包括设备属性、配置、驱动程序等。通过对获得的设备信息的操作，我们可以实现各种设备方案。