Click here to Skip to main content
Click here to Skip to main content

Device Property Sheet Dialog

, 12 Aug 2004
Rate this:
Please Sign up or sign in to vote.
Showing property sheet dialog of a specific device.

Sample Image - DevicePropertySheet.jpg

Introduction

In my last article (Enumerate Properties of an Installed Device), I used Setup APIs to enumerate all of the properties of an installed device. But these properties are common for all devices and there were no specific properties that differ with other devices' properties. For example, a sound card has some properties that are different with properties of a network adapter.

Also, during these months, several developers asked me for device specific properties and how can one change them programmatically. I searched over the net but I could not find any related article. Now, this article is my effort to solving the problem.

Reverse Engineering The Device Manager

The first step is searching the MSDN. I searched the MSDN to find any API related to Device Manager; for example, an API that gets some information about a device (e.g., DevNode, Device GUID or etc.) and shows a dialog (may be Device Property Sheet) of properties. But there is no such API. At least, I can't find any, if anyone knows such an API, I would be glad to be informed.

The second step is to study more about the Device Manager. The Device Manager is a DLL (DevMgr.dll) that is used in MMC as a snap-in. Figure 2 shows it:

Device Manager

I used PE File Explorer (a free utility with source code) for exploring PE (Portable Executable) files like *.exe, *.dll, *.ocx, and etc.

With this utility, I found exported functions. That made an idea for me. How can other programs call these exported (and also undocumented) functions to show device property sheets?

Figure 3 shows PEFileExplorer that opens DevMgr.dll.

Sample screenshot

A big step was done with PEFileExplorer. Now I know which functions are exported by the DLL, and this makes me to search about exported functions.

From MSDN, I found that Rundll.exe and Rundll32.exe allow to invoke a function exported from a DLL. However, Rundll and Rundll32 programs do not allow you to call any exported function from any DLL. For example, you can not use these utility programs to call the Win32 API (Application Programming Interface) calls exported from the system DLLs. The programs only allow you to call functions from a DLL that are explicitly written to be called by them.

The command line for Rundll32.exe is as follows:

Rundll32.exe <name of dll> 
       <entry point function> <arguments>

With a deep look on the list of exported functions, everyone can understand that the entry point of DevMgr.dll is DeviceProperties_RunDLLA (ANSI version) and DeviceProperties_RunDLLW (UNICODE version). As Microsoft Knowledge Base Article - 164787 suggests, Rundll32.exe can handle the entry point function without using A or W. In other words, we are required to call the entry point as follows:

Rundll32.exe devmgr.dll DeviceProperties_RunDLL /DeviceID 
                                            root\system\0000

The above syntax means Rundll32.exe should call DeviceProperties_RunDll (as an entry point of DevMgr.dll) and pass /DeviceID root\system\0000 as argument of the function.

Solution

In the previous article, I showed you how we can obtain DeviceID of an installed device. Then by calling Rundll32.exe with proper arguments, the property sheet of an installed device will appear.

The following code shows an example:

void CDevicePropertySheetDialogDlg::OnDeviceProperty() 
{
    DEVNODE dn;
    
    for (int i=0; i<m_Devices.GetItemCount(); i++)
    {
        if (m_Devices.GetItemState(i, LVIS_SELECTED)) //item was selected
        {
            dn=(DEVNODE) m_Devices.GetItemData(i);
            break;
        }
    }
    
    CString CommandLine;

    //Enumerate properties
    for (int j=0; j<DeviceProperty.size(); j++)
    {
        if (DeviceProperty[j].dn==dn)
        {
            CommandLine.Format(_T("DevMgr.dll 
                  DeviceProperties_RunDLL /DeviceID \"%s\""),
                  DeviceProperty[j].Properties[ID_DEVICEID].PropertyValue);
            break;
        }
    }
    
    ShellExecute(m_hWnd, _T("open"), _T("Rundll32.exe"), 
                                CommandLine, NULL, SW_SHOW);
}

I assume that all of the devices listed in a list view control (m_Devices) and properties of the device (including DeviceID) are saved in DevicePropert vector.

Alternative Way

An alternative way is to load DevMgr.dll dynamically with LoadLibrary API. Here is the changed code to load the device property sheet with LoadLibrary API:

void CDevicePropertySheetDialogDlg::OnDeviceProperty() 
{
    DEVNODE dn;

    for (int i=0; i<m_Devices.GetItemCount(); i++)
    {
        if (m_Devices.GetItemState(i, LVIS_SELECTED)) //item was selected
        {
            //AfxMessageBox(m_Devices.GetItemText(i, 0));
            dn=(DEVNODE) m_Devices.GetItemData(i);
            break;
        }
    }

    CString CommandLine;

    //Enumerate properties
    for (int j=0; j<DeviceProperty.size(); j++)
    {
        if (DeviceProperty[j].dn==dn)
        {
            CommandLine.Format(_T("/MachineName \"\" /DeviceID %s"),
                        DeviceProperty[j].Properties[ID_DEVICEID].PropertyValue);

            break;
        }
    }

    PDEVICEPROPERTIES pDeviceProperties;
    HINSTANCE hInst=AfxGetInstanceHandle();
    HINSTANCE  hDevMgr = LoadLibrary(_TEXT("devmgr.dll"));
    if (hDevMgr) 
    {
        pDeviceProperties = (PDEVICEPROPERTIES) GetProcAddress((HMODULE) hDevMgr, 
            DeviceProperties_RunDLL);
    }

    if (pDeviceProperties)
    {
        pDeviceProperties(m_hWnd, hInst, CommandLine.GetBuffer(0), SW_SHOW);
    }

}

It should be noticed that DeviceProperties_RunDLL is defined as below:

#ifdef _UNICODE 
#define DeviceProperties_RunDLL  "DeviceProperties_RunDLLW"
typedef void (_stdcall *PDEVICEPROPERTIES)(
                   HWND hwndStub,
                   HINSTANCE hAppInstance,
                   LPWSTR lpCmdLine,
                   int    nCmdShow
                   );

#else
#define DeviceProperties_RunDLL  "DeviceProperties_RunDLLA"
typedef void (_stdcall *PDEVICEPROPERTIES)(
                   HWND hwndStub,
                   HINSTANCE hAppInstance,
                   LPSTR lpCmdLine,
                   int    nCmdShow
                   );
#endif

Thanks to Martin Rubas for his comment.

Enjoy!

License

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

Share

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


Comments and Discussions

 
GeneralMy vote of 5 PinprofessionalAmir Mohammad Nasrollahi9-Aug-13 21:32 
GeneralMy vote of 5 Pinmembermanoj kumar choubey26-Feb-12 20:56 
Nice
GeneralAdd an extra device property tab into device Properties Pinmembercharle_hsin8-Jul-09 11:57 
GeneralMoshkel dar tashkhiseh Cart Seda (Sound Cards) Pinmemberkoorosh4-Jan-07 8:27 
QuestionUninstall device from the Device Manager Pinmemberararavikar27-Apr-06 10:32 
AnswerRe: Uninstall device from the Device Manager PinmemberA. Riazi28-Apr-06 1:59 
GeneralRe: Uninstall device from the Device Manager Pinmemberararavikar28-Apr-06 12:46 
AnswerRe: Uninstall device from the Device Manager PinmemberA. Riazi28-Apr-06 15:48 
QuestionHow to open COM Port Advanced Settings Pinmemberquantum197615-Feb-06 20:32 
GeneralRetrieve USB Info PinmemberLiYS28-Oct-05 7:18 
GeneralRe: Retrieve USB Info PinmemberA. Riazi28-Oct-05 22:23 
GeneralRe: Retrieve USB Info PinmemberLiYS29-Oct-05 6:10 
GeneralRe: Retrieve USB Info PinmemberA. Riazi30-Oct-05 3:18 
GeneralRe: Retrieve USB Info PinmemberLiYS30-Oct-05 15:48 
GeneralCapture device signal detection Pinmembertony070731-Aug-05 11:48 
GeneralEnable / Disable network card device PinsussARTsoft31-May-05 6:20 
GeneralExported Functions... PinmemberdaDude26-Oct-04 23:28 
GeneralRe: Exported Functions... PinmemberA. Riazi27-Oct-04 1:11 
GeneralNice work, but look at MS KB 815320 PinmemberMerlin99cz8-Aug-04 23:40 
GeneralDLL Application PinmemberErnest Laurentin2-Aug-04 6:45 
GeneralRe: DLL Application PinmemberA. Riazi2-Aug-04 8:17 
GeneralRe: DLL Application PinmemberErnest Laurentin2-Aug-04 14:46 
GeneralGood Pinmembernorm.net1-Aug-04 22:17 
GeneralRe: Good PinmemberA. Riazi1-Aug-04 22:57 
GeneralWon't compile...fixed Pinmemberdoctrane1-Aug-04 17:04 

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

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

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.141223.1 | Last Updated 13 Aug 2004
Article Copyright 2004 by A. Riazi
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid