SetUpDi系列函数获取系统设备信息

 

 

1  SetupDiGetClassDevs函数

The SetupDiGetClassDevs function returns a handle to a device information set that contains requested device information elements for a local machine.

我的理解也就是这个函数能返回一个包含某个设备集合信息的一个指针。这里的handle暂且这么理解。

用SetupDiGetClassDevs得到的这个handle，最后记得要调用SetupDiDestroyDeviceInfoList来删除。

2  SetupDiEnumDeviceInfo函数

The SetupDiEnumDeviceInfo function returns a SP_DEVINFO_DATA structure that specifies a device information element in a device information set.

我的理解：用第一个函数得到了一个设备集合的handle，然后根据此handle用SetupDiEnumDeviceInfo可以枚举出来该设备集合中某一个设备的信息。而这些信息保存在SP_DEVINFO_DATA这样一个结构体中。实际上这里得到的还不是某一个设备的具体信息，这里得到的只是一个指针，这个指针指向了一个包含该设备所有信息的集合。一个设备可能有很多信息，比如设备描述，设备名称，设备占有资源等等。要得到该设备具体的某一项信息需要用到下面要说的第3个函数：

3  SetupDiGetDeviceRegistryProperty

The SetupDiGetDeviceRegistryProperty function retrieves a specified Plug and Play device property.

用这个函数可以在前面得到的指向某一个具体设备信息集合的指针中取出某一项信息。

其实上面三个函数是从不同的层面上来一步一步的得到某一个设备的具体的信息的。

就拿网卡来说吧，这个三个层次如下：

一台机器上的网卡GUID->具体到某一个网卡的信息集合->一个集合中的一个具体的信息。

[cpp] view plain copy print ?

1. BOOL CollectNetCardInfo::GetAllPhysicsNetCardName() 
2. { 
3.     BOOL        bRet = TRUE; 
4.     GUID  NetCardClassGuid   =    
5.     {0X4D36E972,   0XE325,   0X11CE,   {0XBF,   0XC1,   0X08,   0X00,   0X2B,   0XE1,   0X03,   0X18}}; 
6.  
7.     //得到一个Class下信息集句柄 
8.     m_NewDeviceInfoSet = SetupDiGetClassDevs(&NetCardClassGuid, NULL, NULL, DIGCF_PRESENT); 
9.     if(m_NewDeviceInfoSet == INVALID_HANDLE_VALUE) 
10.     { 
11.         wprintf(_T("NewDeviceInfoSet == INVALID_HANDLE_VALUE")); 
12.         bRet = FALSE; 
13.         return bRet; 
14.     } 
15.  
16.     //对得到的此class信息集进行枚举 
17.     for(int Device_Index=0; ; Device_Index++) 
18.     { 
19.         memset((void*)&(m_NetCardDevInfoData), 0, sizeof(SP_DEVINFO_DATA)); 
20.         m_NetCardDevInfoData.cbSize = sizeof(SP_DEVINFO_DATA); 
21.         BOOL        bResult  = SetupDiEnumDeviceInfo(m_NewDeviceInfoSet, Device_Index, &m_NetCardDevInfoData); 
22.         if(bResult == 0) 
23.         { 
24.             if(GetLastError() == ERROR_NO_MORE_ITEMS) 
25.             { 
26.                 break; 
27.             } 
28.         } 
29.  
30.         DWORD   dwBufSize = 0; 
31.         BYTE       *pbReuslt = MySetupDiGetDeviceRegistryProperty( 
32.                 SPDRP_ENUMERATOR_NAME ,  
33.                 NULL,&dwBufSize); 
34.         if(pbReuslt) 
35.         { 
36.             TCHAR *tcName = (TCHAR*)pbReuslt; 
37.             _wcsupr_s(tcName,dwBufSize); 
38.             if(wcscmp(tcName,_T("ROOT")) != 0) 
39.             { 
40.                 m_NetCardNum++; 
41.                 GetNetCardDes(); 
42.             } 
43.  
44.             free(pbReuslt); 
45.         } 
46.     } 
47.     //销毁一个Class的device information set 
48.     SetupDiDestroyDeviceInfoList(m_NewDeviceInfoSet); 
49.     return bRet; 
50. } 
51. void CollectNetCardInfo::GetNetCardDes() 
52. { 
53.     DWORD   dwBufSize = 0; 
54.     BYTE     *pbTemp =  MySetupDiGetDeviceRegistryProperty( 
55.                         SPDRP_DEVICEDESC,  
56.                         NULL,&dwBufSize); 
57.     if(pbTemp) 
58.     { 
59.         BYTE     *pbNetDes = new BYTE[dwBufSize]; 
60.         memset(pbNetDes,0x00,dwBufSize); 
61.         memcpy(pbNetDes,pbTemp,dwBufSize); 
62.         m_NetCardDesMap.insert(make_pair(m_NetCardNum,pbNetDes)); 
63.         free(pbTemp); 
64.     } 
65. } 
66. BYTE* CollectNetCardInfo::MySetupDiGetDeviceRegistryProperty( 
67.     IN DWORD  Property, 
68.     OUT PDWORD  PropertyRegDataType , 
69.     OUT PDWORD  pdwBufSize) 
70. { 
71.     DWORD       Required_Size = 0; 
72.     BOOL bResult = SetupDiGetDeviceRegistryProperty( 
73.                     m_NewDeviceInfoSet,  
74.                     &m_NetCardDevInfoData,  
75.                     Property ,  
76.                     PropertyRegDataType,  
77.                     NULL, 0,  
78.                     &Required_Size); 
79.     if(!bResult) 
80.     { 
81.         if(ERROR_INSUFFICIENT_BUFFER == GetLastError()) 
82.         { 
83.             *pdwBufSize = Required_Size; 
84.             BYTE        *PropertyBuffer = (BYTE*)malloc(Required_Size); 
85.  
86.             bResult = SetupDiGetDeviceRegistryProperty( 
87.                     m_NewDeviceInfoSet,  
88.                     &m_NetCardDevInfoData,  
89.                     Property ,  
90.                     PropertyRegDataType,  
91.                     PropertyBuffer,  
92.                     Required_Size, NULL); 
93.             if(bResult) 
94.                 return PropertyBuffer; 
95.             else 
96.             { 
97.                 free(PropertyBuffer); 
98.                 return NULL; 
99.             } 
100.         } 
101.         else 
102.             return NULL; 
103.     } 
104.     else 
105.         return NULL; 
106. }