C# Signature:

[DllImport("setupapi.dll", CharSet = CharSet.Auto)]
static extern IntPtr SetupDiGetClassDevs(
                                              ref Guid ClassGuid,
                                              [MarshalAs(UnmanagedType.LPTStr)] string Enumerator,
                                              IntPtr hwndParent,
                                              UInt32 Flags
                                             );

Alternate Signatures:

[DllImport("setupapi.dll", CharSet = CharSet.Auto)]
static extern IntPtr SetupDiGetClassDevs(           // 1st form using a ClassGUID
   ref Guid ClassGuid,
   int  Enumerator,
   IntPtr hwndParent,
   int Flags
);
[DllImport("setupapi.dll", CharSet = CharSet.Auto)]     // 2nd form uses an Enumerator
static extern IntPtr SetupDiGetClassDevs(
   int ClassGuid,
   string Enumerator,
   IntPtr hwndParent,
   int Flags
);

VB Signatures:

    <DllImport("setupapi.dll", _
    EntryPoint:="SetupDiGetClassDevsW", _
    SetLastError:=True, _
    CharSet:=CharSet.Unicode, _
    ExactSpelling:=True, _
    PreserveSig:=True, _
    CallingConvention:=CallingConvention.Winapi)> _
    Private Shared Function SetupDiGetClassDevs( _
    ByRef ClassGuid As GUID, _
    ByVal Enumerator As Integer, _
    ByVal hwndParent As Integer, _
    ByVal Flags As Integer) As Integer
    End Function

    <DllImport("setupapi.dll", _
    EntryPoint:="SetupDiGetClassDevsW", _
    SetLastError:=True, _
    CharSet:=CharSet.Unicode, _
    ExactSpelling:=True, _
    PreserveSig:=True, _
    CallingConvention:=CallingConvention.Winapi)> _
    Private Shared Function SetupDiGetClassDevs( _
    ByRef ClassGuid As GUID, _
    ByVal samDesired As Integer, _
    ByVal Flags As Integer, _
    ByRef hwndParent As String, _
    ByVal Reserved As Integer) As Integer
    End Function

User-Defined Types:

const int DIGCF_PRESENT = 0x2;
const int DIGCF_ALLCLASSES = 0x4;
const int DIGCF_DEVICEINTERFACE = 0x10;

Alternative Managed API:

Do you know one? Please contribute it!

Notes:

None.

Tips & Tricks:

When finished using the device information set, the application should free the resources used by calling SetupDiDestroyDeviceInfoList

Sample Code:

Guid DiskGUID = new Guid(GUID_DEVINTERFACE_DISK);

// We start at the "root" of the device tree and look for all
// devices that match the interface GUID of a disk
IntPtr h = SetupDiGetClassDevs(ref DiskGUID, 0, IntPtr.Zero, DIGCF_PRESENT | DIGCF_DEVICEINTERFACE);
if (h.ToInt32() != INVALID_HANDLE_VALUE)
{
   bool Success = true;
   int i = 0;
   while (Success)
   {
     // create a Device Interface Data structure
     SP_DEVICE_INTERFACE_DATA dia = new SP_DEVICE_INTERFACE_DATA();
     dia.cbSize = Marshal.SizeOf(dia);

     // start the enumeration
     Success = SetupDiEnumDeviceInterfaces(h, IntPtr.Zero, ref DiskGUID, i, ref dia);
     if (Success)
     {
    // build a DevInfo Data structure
    SP_DEVINFO_DATA da = new SP_DEVINFO_DATA();
    da.cbSize = Marshal.SizeOf(da);

    // build a Device Interface Detail Data structure
    SP_DEVICE_INTERFACE_DETAIL_DATA didd = new SP_DEVICE_INTERFACE_DETAIL_DATA();
    didd.cbSize = 4 + Marshal.SystemDefaultCharSize; // trust me :)

    // now we can get some more detailed information
    int nRequiredSize = 0;
    int nBytes = BUFFER_SIZE;
    if (SetupDiGetDeviceInterfaceDetail(h, ref dia, ref didd, nBytes, ref nRequiredSize, ref da))
    {
      // current InstanceID is at the "USBSTOR" level, so we
      // need up "move up" one level to get to the "USB" level
      IntPtr ptrPrevious;
      CM_Get_Parent(out ptrPrevious, da.DevInst, 0);

      // Now we get the InstanceID of the USB level device
      IntPtr ptrInstanceBuf = Marshal.AllocHGlobal(nBytes);
      CM_Get_Device_ID(ptrPrevious, ptrInstanceBuf, nBytes, 0);
      string InstanceID = Marshal.PtrToStringAuto(ptrInstanceBuf);

      Marshal.FreeHGlobal(ptrInstanceBuf);
    }
      }
    }
    i++;
  }
  SetupDiDestroyDeviceInfoList(h);
}