Click here to Skip to main content
13,293,894 members (59,649 online)
Click here to Skip to main content
Add your own
alternative version


99 bookmarked
Posted 16 Mar 2004

Enumerate Installed Devices Using Setup API

, 16 Mar 2004
Rate this:
Please Sign up or sign in to vote.
Enumerate installed devices on a local or remote computer.

Sample Image - EnumDevices.jpg


Windows has a rich collection of APIs to get useful information about installed devices. In this article, I will show how you can enumerate devices on a machine using Setup API.

The program has a simple GUI: only a list control that shows all of the installed devices. All the information about a device (such as name and its icon) is grabbed from Windows Setup API.

Setup API

The Setup application programming interface (API) provides a set of functions that your setup application can call to perform installation operations or get several information about installed devices, their class and also their GUID (a unique identifier for every device).

The application requires the following APIs (description of these APIs was taken from MSDN):

        OUT CLASSIMAGELIST_DATA ClassImageListData);

The SetupDiGetClassImageList function builds an image list that contains bitmaps for every installed class and returns the list in a data structure.

        IN PSP_CLASSIMAGELIST_DATA ClassImageListData);

The SetupDiDestroyClassImageList function destroys a class image list that was built by a call to SetupDiGetClassImageList.

        IN PSP_CLASSIMAGELIST_DATA ClassImageListData, 
        IN LPGUID ClassGuid, 
        OUT PINT ImageIndex);

The SetupDiGetClassImageIndex function retrieves the index within the class image list of a specified class.

            IN PCTSTR  UNCServerName,
            OUT PHMACHINE  phMachine);

            IN HMACHINE  hMachine);

The CM_Connect_Machine function creates a connection to a local or remote machine. The CM_Disconnect_Machine function removes a connection to a local or remote machine.

        OUT PDEVINST  pdnDevInst,
        IN ULONG  ulFlags,
        IN HMACHINE  hMachine);

The CM_Locate_DevNode_Ex function obtains a device instance handle to the device node that is associated with a specified device instance identifier, on a local or a remote machine.

pDeviceID represents a device instance identifier. If this value is NULL, or if it points to a zero-length string, the function supplies a device instance handle to the device node at the top of the device tree. The PnP Manager maintains a device tree that keeps track of the devices in the system. The following figure shows the device tree for a sample system configuration. The device tree contains information about the devices present on the system. The PnP Manager builds this tree when the machine boots, using information from drivers and other components, and updates the tree as devices are added or removed. Each node of the device tree is called a device node, or devnode. A devnode consists of the device objects for the device's drivers, plus internal information maintained by the system. Therefore, there is a devnode for each device stack.

Device Tree

        OUT PDEVINST  pdnDevInst,
        IN DEVINST  dnDevInst,
        IN ULONG  ulFlags,
        IN HMACHINE  hMachine);

The CM_Get_Child_Ex function is used to retrieve a device instance handle to the first child node of a specified device node, in a local or a remote machine's device tree.

        OUT PDEVINST  pdnDevInst,
        IN DEVINST  DevInst,
        IN ULONG  ulFlags,
        IN HMACHINE  hMachine);

The CM_Get_Sibling_Ex function obtains a device instance handle to the next sibling node of a specified device node, in a local or a remote machine's device tree.


According to the above functions, we should first establish a connection to our computer (local or remote), then get the top node of the device tree (Root device). After this, we should enumerate the installed devices by a simple loop. The application uses three function: EnumDevices(), RetrieveSubNodes() and GetDeviceName(). Following is the source of them:

void EnumDevices()
    TCHAR LocalComputer[MAX_PATH];
    DWORD Size = MAX_PATH - 2;
    GetComputerName(LocalComputer + 2, &Size);
    LocalComputer[0] = _T('\\');
    LocalComputer[1] = _T('\\');
    cr = CM_Connect_Machine(LocalComputer, &m_hMachine);
    if (cr != CR_SUCCESS)
        TCHAR Text[MAX_PATH];
        wsprintf(Text, _T("Machine Connection failed, cr= %lx(hex)\n"), cr);
    ::MessageBox(m_hWnd, Text, _T("Error"), MB_ICONSTOP | MB_OK);
    //Set Image List 
    m_ImageListData.cbSize = sizeof(m_ImageListData);

    m_Devices.SetImageList(&m_ImageList, LVSIL_SMALL);
    m_Devices.SetImageList(&m_ImageList, LVSIL_NORMAL);

    DEVNODE dnRoot;
    CM_Locate_DevNode_Ex(&dnRoot, NULL, 0, m_hMachine);
    DEVNODE dnFirst;
    CM_Get_Child_Ex(&dnFirst, dnRoot, 0, m_hMachine);    

    RetrieveSubNodes(dnRoot, NULL, dnFirst);


void RetrieveSubNodes(DEVINST parent, DEVINST sibling, DEVNODE dn)
    DEVNODE dnSibling, dnChild;
        CONFIGRET cr = CM_Get_Sibling_Ex(&dnSibling, dn, 0, m_hMachine);
        if (cr != CR_SUCCESS)
        dnSibling = NULL;
    ULONG Size = sizeof(GuidString);
    cr = CM_Get_DevNode_Registry_Property_Ex(dn, CM_DRP_CLASSGUID, NULL,
        GuidString, &Size, 0,  m_hMachine);
    if (cr == CR_SUCCESS)
        GUID Guid;
        GuidString[MAX_GUID_STRING_LEN - 2] = _T('\0');
        UuidFromString(&GuidString[1], &Guid);
        int Index;
        if (SetupDiGetClassImageIndex(&m_ImageListData, &Guid, &Index))
                CString DeviceName=GetDeviceName(dn);
        m_Devices.InsertItem(m_Devices.GetItemCount(), DeviceName, Index);
    cr = CM_Get_Child_Ex(&dnChild, dn, 0, m_hMachine);
    if (cr == CR_SUCCESS)
        RetrieveSubNodes(dn, NULL, dnChild);
    dn = dnSibling;
    } while (dn != NULL);

CString GetDeviceName(DEVNODE DevNode)
    CString    strType;
    CString    strValue;
    CString DisplayName;
    LPTSTR    Buffer;
    int  BufferSize = MAX_PATH + MAX_DEVICE_ID_LEN;
    ULONG  BufferLen = BufferSize * sizeof(TCHAR);
    Buffer  = strValue.GetBuffer(BufferSize);
    if (CR_SUCCESS == CM_Get_DevNode_Registry_Property_Ex(DevNode,
        Buffer, &BufferLen, 0, m_hMachine))
    DisplayName = Buffer;
    BufferLen = BufferSize * sizeof(TCHAR);
    if (CR_SUCCESS == CM_Get_DevNode_Registry_Property_Ex(DevNode,
        Buffer, &BufferLen, 0, m_hMachine))
        DisplayName = Buffer;
        DisplayName=_T("Unknown Device");
    return DisplayName;

m_Devices is a list control, m_ImageList is an image list of device icons and m_hMachine is a handle of the connected machine.



This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

A. Riazi
CEO Misbah3Com
Iran (Islamic Republic of) Iran (Islamic Republic of)
I was born in Shiraz, a very beautiful famous city in Iran. I started programming when I was 12 years old with GWBASIC. Since now, I worked with various programming languages from Basic, Foxpro, C/C++, Visual Basic, Pascal to MATLAB and now Visual C++.
I graduated from Iran University of Science & Technology in Communication Eng., and now work as a system programmer for a telecommunication industry.
I wrote several programs and drivers for Synthesizers, Power Amplifiers, GPIB, GPS devices, Radio cards, Data Acqusition cards and so many related devices.
I'm author of several books like Learning C (primary and advanced), Learning Visual Basic, API application for VB, Teach Yourself Object Oriented Programming (OOP) and etc.
I'm winner of January, May, August 2003 and April 2005 best article of month competetion, my articles are:

You can see list of my articles, by clicking here

You may also be interested in...


Comments and Discussions

GeneralMy vote of 5 Pin
Amir Mohammad Nasrollahi9-Aug-13 21:25
professionalAmir Mohammad Nasrollahi9-Aug-13 21:25 
GeneralMy vote of 5 Pin
manoj kumar choubey26-Feb-12 20:55
membermanoj kumar choubey26-Feb-12 20:55 
QuestionLicense for this code Pin
mikejurka30-Apr-09 6:36
membermikejurka30-Apr-09 6:36 
GeneralFinding a specific device... Pin
Sharath Madhuranath14-Apr-09 2:50
memberSharath Madhuranath14-Apr-09 2:50 
Generalserial number of a connected mass storage device Pin
madddi9-Mar-09 8:56
membermadddi9-Mar-09 8:56 
QuestionCan you tell me how to enumerate 3G device from PC Pin
alert091928-Jul-08 0:30
memberalert091928-Jul-08 0:30 
QuestionCM_Get_DevNode_Registry_Property_Ex not safe Pin
Ingeer13-Nov-07 14:25
memberIngeer13-Nov-07 14:25 
QuestionHow to detect if a network card is disabled Pin
samaruf9-May-07 2:05
membersamaruf9-May-07 2:05 
Generalhard disk serial Pin
nicolas20027-Apr-07 14:34
membernicolas20027-Apr-07 14:34 
GeneralRe: hard disk serial Pin
A. Riazi1-May-07 0:31
memberA. Riazi1-May-07 0:31 
GeneralRe: hard disk serial Pin
nicolas2002-May-07 5:39
membernicolas2002-May-07 5:39 
GeneralRe: hard disk serial Pin
nicolas20014-May-07 8:00
membernicolas20014-May-07 8:00 
Generalthank A.Riazi! Pin
brocean31-Mar-07 0:53
memberbrocean31-Mar-07 0:53 
GeneralRe: thank A.Riazi! Pin
A. Riazi2-Apr-07 1:38
memberA. Riazi2-Apr-07 1:38 
QuestionLinker error mfc42ud.lib not found Pin
Rahul U. Kate7-Mar-07 2:36
memberRahul U. Kate7-Mar-07 2:36 
Questionbackup drivers Pin
mohcin16-Jan-06 0:30
membermohcin16-Jan-06 0:30 
QuestionBackup drivers Pin
mohcin13-Jan-06 23:50
membermohcin13-Jan-06 23:50 
GeneralEnumerate devices on Windows NT Pin
prabhakarks25-Nov-05 3:26
memberprabhakarks25-Nov-05 3:26 
AnswerRe: Enumerate devices on Windows NT Pin
A. Riazi28-Nov-05 4:09
memberA. Riazi28-Nov-05 4:09 
QuestionHow can I enumerate uninstalled devices? Pin
guang peng13-Nov-05 17:25
memberguang peng13-Nov-05 17:25 
AnswerRe: How can I enumerate uninstalled devices? Pin
A. Riazi13-Nov-05 23:32
memberA. Riazi13-Nov-05 23:32 
GeneralRe: How can I enumerate uninstalled devices? Pin
guang peng15-Nov-05 15:41
memberguang peng15-Nov-05 15:41 
GeneralEnumerate Devices without DDK Pin
inf00910-Nov-05 5:16
memberinf00910-Nov-05 5:16 
GeneralUuidFromString error Pin
rovan27-Sep-05 3:30
sussrovan27-Sep-05 3:30 
AnswerRe: UuidFromString error Pin
A. Riazi13-Nov-05 23:36
memberA. Riazi13-Nov-05 23:36 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.171207.1 | Last Updated 17 Mar 2004
Article Copyright 2004 by A. Riazi
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid