使用SetupDI* API列举系统中的设备

Instroduction

在Windows系统中提供一组有用的函数来撷取以安装设备(Device)的信息与增加或解除设备(Device)的安装。在本文中，我将显示如何使用SetupDIXXX与CM_XXX 等API来列举本机上的设备。

在范例程序中并无复杂的画面,只有一个简单的TreeView与ListView控件。TreeLivew控件用来显示所有安装的设备名称，ListView控件则用来显示在TreeView控件中所指定项目的相关信息。所有设备的相关信息(例如：名称,资源与图示等)都是从SetupDiXXX API中所取得的。

SetupDiXXX

设定安装程序接口 (Setup Application Programming Interface) 提供一组函数来让您的设定安装程序能执行安装的动作或取得设备的相关信息，类别 (Class) 与它的 GUID 值。

首先要取的所列举的设备的位图 (Bitmap) ，我们可以呼叫以下的函数：

SetupDiGetClassImageList([OUT]CLASSIMAGELIST_DATA ClassImageListData);

呼叫这个函数会取得每一个已安装设备的位图并建立位图串行。

SetupDiDestroyClassImageList([IN] PSP_CLASSIMAGELIST_DATA

                                                            ClassImageListData);

呼叫这个函数会释放之前呼叫 SetupDiGetClassImageList 所占有的资源。

SetupDiGetClassImageIndex([IN] PSP_CLASSIMAGELIST_DATA

                                                                       ClassImageListData,

                                           [IN] LPGUID ClassGuid,

                                           [OUT] PINT ImageIndex);

呼叫这个函数会取得每一个已安装设备的位图的索引值。

hDevInfo = SetupDiGetClassDevs(0L, 0L, _hDlg, DIGCF_PRESENT |

                                                    DIGCF_ALLCLASSES | DIGCF_PROFILE);

取得设备的信息。首次呼叫时，第一个参数与第二个参数将它们设为 ”0 ” ，而第三个参数则设定 DIGCF_ALLCLASSES 旗标，设定此旗标代表要取得所有设备的信息。如果有设定此旗标此时第一个参数将会被忽略。

Geting the Info

呼叫 SetupDiEnumDeviceInfo 来列举本机上所有的设备。

SetupDiEnumDeviceInfo(hDevInfo, wIndex, &spDevInfoData))

第一个参数为之前呼叫 SetupDiGetDevs 函数所传回的代码 (Handle) 。第二个参数为以 ”0” 为基底的索引值，第三个参数为指向 SP_DEVINFO_DATA 结构的指针。使用此结构时须先设定结构大小。

                spDevInfoData.cbSize = sizeof(SP_DEVINFO_DATA);

SetupDiGetDeviceRegistryProperty(hDevInfo,

                                        &spDevInfoData,

// Supplies one of the following values, indicating the property to be retrieved.

                                        SPDRP_CLASS,

                                        0L,

                                        (PBYTE)szBuf,

                                        2048,

                                        0);

呼叫 SetupDiGetDeviceRegistreProperty 函数从 Registry 中取得设备名称。第三个参数为指定要取得何种信息。

Device Resource

在系统中所有的设备会与类别设备结合在一起。请参下图。这个类别可以是GUID(可以在Registry中寻获)或是设备的描述。例如：”Ports”类别是描述(COM与LPT)。

要取得目前的设备的结构(Configuartion)我们可以呼叫CM_Get_First_Log_Conf函数来取得。然后呼叫CM_Get_Next_res_Des来取得目前设备结构的描述，重复呼叫直到浏览完所有的结构为止。

当此函数成功执行后，我们接着呼叫CM_Get_Res_Des_Data函数来取的资源的数据。

要安装驱动程序，我们可以透过 Service API 来达成，如果要安装 WDM 的程序，此时呼叫 SetupDiGetINFClass 函数先取得此驱动的 GUID 值，在呼叫 SetupDiCreateDeviceInfoList 来建立一个新的设备。如下列片断程序代码：

    if (!SetupDiGetINFClass(szINFName, &guid, className, MAX_CLASS_NAME_LEN, 0)){

        ShowErrorMsg(_hDlg, GetLastError(), "SetupDiGetINFClass");

        return 0;

    };

    hDevInfo = SetupDiCreateDeviceInfoList(&guid, 0);

    if (hDevInfo == (void*)-1) {

        ShowErrorMsg(_hDlg, GetLastError(), "SetupDiCreateDeviceInfoList");

        return 0;

    };

    spDevData.cbSize = sizeof(SP_DEVINFO_DATA);

    if (!SetupDiCreateDeviceInfo(hDevInfo,

                                 className,

                                 &guid,

                                 0L, 0L, DICD_GENERATE_ID,

                                 &spDevData))

                           ．

                           ．

                           ．

接下来我们要呼叫 SetupDiSetDeviceRegistryProperty 函数来设定 Registry 中的内容。设定完成后，呼叫 SetupDiCallClassInstaller 函数依据 Registry 的内容来安装驱动程序。最后呼叫 UpdateDriverForPlugAndPlayDevices 函数来更新设备串行的内容。

if (!SetupDiSetDeviceRegistryProperty(hDevInfo,

                                       &spDevData,

                                       SPDRP_HARDWAREID,

                                       (PBYTE)pHID,

                           (strlen(_szHardware[wLoop])*2*sizeof(char)))) {

            ShowErrorMsg(_hDlg, GetLastError(), "SetupDiSetDeviceRegistryProperty");

            SetupDiDestroyDeviceInfoList(hDevInfo);

            LocalFree(pHID);

            return 0;

        };

        if (!SetupDiCallClassInstaller(DIF_REGISTERDEVICE,

                                       hDevInfo, &spDevData)) {

            ShowErrorMsg(_hDlg, GetLastError(), "SetupDiCallClassInstaller");

            SetupDiDestroyDeviceInfoList(hDevInfo);

            LocalFree(pHID);

            return 0;

        };

        bRebootRequired = 0;

        if (!UpdateDriverForPlugAndPlayDevices(0L, _szHardware[wLoop],

                           ．

                           ．

                           ．

本文就此结束，希望对您会有帮助。原始程序，我已放在 http://www.codeproject.com/useritems/SimpleSetup.asp 中，如果有兴趣请自行下载。