詳解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函數，我們可以獲取某台電腦上的設備信息，包括設備屬性、配置、驅動程序等。通過對獲得的設備信息的操作，我們可以實現各種設備方案。