C# Signature:

[DllImport("setupapi.dll", SetLastError=true)]
static extern bool SetupDiEnumDeviceInfo(IntPtr DeviceInfoSet, uint MemberIndex, ref SP_DEVINFO_DATA DeviceInfoData);

VB Signature:

    <DllImport("setupapi.dll", _
    EntryPoint:="SetupDiEnumDeviceInfo", _
    SetLastError:=True, _
    CharSet:=CharSet.Unicode, _
    ExactSpelling:=True, _
    PreserveSig:=True, _
    CallingConvention:=CallingConvention.Winapi)> _
    Private Shared Function SetupDiEnumDeviceInfo( _
    ByVal DeviceInfoSet As Integer, _
    ByVal MemberIndex As Integer, _
    ByRef DeviceInfoData As SP_DEVINFO_DATA) As Boolean
    End Function

User-Defined Types:

SP_DEVINFO_DATA

Alternative Managed API:

Do you know one? Please contribute it!

Notes:

The SetupDiEnumDeviceInfo function retrieves a context structure for a device information element of the specified device information set. Each call returns information about one device. The function can be called repeatedly to get information about several devices.

Parameters

DeviceInfoSet

in Handle to the device information set containing the devices for which to return element information.

MemberIndex

in Zero-based index to the list of interfaces in the device information set. You should first call this function with the MemberIndex parameter set to zero to obtain the first interface. Then, repeatedly increment MemberIndex and retrieve an interface until this function fails and GetLastError returns ERROR_NO_MORE_ITEMS (259).

DeviceInfoData

out Pointer to an SP_DEVINFO_DATA structure that receives information about this element. You must set the cbSize member to sizeof(SP_DEVINFO_DATA) before calling this function.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Tips & Tricks:

Please add some!

Sample Code:

    static string GetDescriptionByKeyName(string DriverKeyName)
    {
        string ans = "";
        string DevEnum = REGSTR_KEY_USB;

        // Use the "enumerator form" of the SetupDiGetClassDevs API
        // to generate a list of all USB devices
        IntPtr h = SetupDiGetClassDevs(0, DevEnum, IntPtr.Zero, DIGCF_PRESENT | DIGCF_ALLCLASSES);
        if (h.ToInt32() != INVALID_HANDLE_VALUE)
        {
        IntPtr ptrBuf = Marshal.AllocHGlobal(BUFFER_SIZE);
        string KeyName;

        bool Success = true;
        int i = 0;
        while (Success)
        {
            // create a Device Interface Data structure
            SP_DEVINFO_DATA da = new SP_DEVINFO_DATA();
            da.cbSize = Marshal.SizeOf(da);

            // start the enumeration
            Success = SetupDiEnumDeviceInfo(h, i, ref da);
            if (Success)
            {
            int RequiredSize = 0;
            int RegType = REG_SZ;
            KeyName = "";

            if (SetupDiGetDeviceRegistryProperty(h, ref da, SPDRP_DRIVER, ref RegType, ptrBuf, BUFFER_SIZE, ref RequiredSize))
            {
                KeyName = Marshal.PtrToStringAuto(ptrBuf);
            }

            // is it a match?
            if (KeyName == DriverKeyName)
            {
                if (SetupDiGetDeviceRegistryProperty(h, ref da, SPDRP_DEVICEDESC, ref RegType, ptrBuf, BUFFER_SIZE, ref RequiredSize))
                {
                ans = Marshal.PtrToStringAuto(ptrBuf);
                }
                break;
            }
            }
            i++;
        }
        Marshal.FreeHGlobal(ptrBuf);
        SetupDiDestroyDeviceInfoList(h);
        }
        return ans;
    }

Please edit this page!

Do you have...

• helpful tips or sample code to share for using this API in managed code?
• corrections to the existing content?
• variations of the signature you want to share?
• additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).