使用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
中，如果有兴趣请自行下载。