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

原文链接地址：https://blog.csdn.net/clteng/article/details/801012?utm_source=blogxgwz8

在Windows系统中提供一组有用的函数来撷取以安装设备(Device)的信息与增加或解除设备(Device)的安装。在本文中，我将显示如何使用SetupDIXXX与CM_XXX 等API来列举本机上的设备。
在范例程序中并无复杂的画面,只有一个简单的TreeView与ListView控件。TreeLivew控件用来显示所有安装的设备名称，ListView控件则用来显示在TreeView控件中所指定项目的相关信息。所有设备的相关信息(例如：名称,资源与图示等)都是从SetupDiXXX API中所取得的。
SetupDiXXX

设定安装程序接口(Setup Application Programming Interface)提供一组函数来让您的设定安装程序能执行安装的动作或取得设备的相关信息，类别(Class)与它的GUID值。
首先要取的所列举的设备的位图(Bitmap)，我们可以呼叫以下的函数：

 WINSETUPAPI BOOL SetupDiGetClassImageList(
   PSP_CLASSIMAGELIST_DATA ClassImageListData
 );

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

 BOOL SetupDiDestroyDeviceInfoList(
   HDEVINFO DeviceInfoSet
 );

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

 WINSETUPAPI BOOL SetupDiGetClassImageIndex(
   PSP_CLASSIMAGELIST_DATA ClassImageListData,
   const GUID              *ClassGuid,
   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,
                                         ,
                                         );

呼叫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, )){
         ShowErrorMsg(_hDlg, GetLastError(), "SetupDiGetINFClass");
         return ;
     };
     hDevInfo = SetupDiCreateDeviceInfoList(&guid, );
     if (hDevInfo == (void*)-) {
         ShowErrorMsg(_hDlg, GetLastError(), "SetupDiCreateDeviceInfoList");
         return ;
     };
     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])**sizeof(char)))) {
             ShowErrorMsg(_hDlg, GetLastError(), "SetupDiSetDeviceRegistryProperty");
             SetupDiDestroyDeviceInfoList(hDevInfo);
             LocalFree(pHID);
             return ;
         };
         if (!SetupDiCallClassInstaller(DIF_REGISTERDEVICE,
                                        hDevInfo, &spDevData)) {
             ShowErrorMsg(_hDlg, GetLastError(), "SetupDiCallClassInstaller");
             SetupDiDestroyDeviceInfoList(hDevInfo);
             LocalFree(pHID);
             return ;
         };
         bRebootRequired = ;
         if (!UpdateDriverForPlugAndPlayDevices(0L, _szHardware[wLoop],
                          ．
                          ．
                          ．