pinvoke.net: Edit: setupapi.SetupDiGetDeviceInstanceId

@msdn=http://search.microsoft.com/search/results.aspx?qu=$$$
@pinvoke=http://pinvoke.net/$$$.htm

Summary: The SetupDiGetDeviceInstanceId function retrieves the device instance ID that is associated with a device information element.

!!!!C# Signature:
 [DllImport("setupapi.dll", SetLastError = true, CharSet = CharSet.Auto)]
 static extern bool SetupDiGetDeviceInstanceId(
   IntPtr DeviceInfoSet,
   ref SP_DEVINFO_DATA DeviceInfoData,
   StringBuilder DeviceInstanceId,
   int DeviceInstanceIdSize,
   out int RequiredSize
 );
!!!!VB Signature:
 Declare Function SetupDiGetDeviceInstanceId Lib "setupapi.dll" (TODO) As TODO

!!!!User-Defined Types:
[SP_DEVINFO_DATA]

!!!!Alternative Managed API:
Do you know one?  Please contribute it!

!!!!Notes:
 WINSETUPAPI BOOL WINAPI  SetupDiGetDeviceInstanceId(
   IN HDEVINFO  DeviceInfoSet,
   IN PSP_DEVINFO_DATA  DeviceInfoData,
   OUT PTSTR  DeviceInstanceId,
   IN DWORD  DeviceInstanceIdSize,
   OUT PDWORD  RequiredSize  OPTIONAL
 );

!!!!Tips & Tricks:
Please add some!

!!!!Sample Code:
        static string GetInstanceIDByKeyName(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)
                        {
                            int nBytes = BUFFER_SIZE;
                            StringBuilder sb = new StringBuilder(nBytes);
                            SetupDiGetDeviceInstanceId(h, ref da, sb, nBytes, out RequiredSize);
                            ans = sb.ToString();
                            break;
                        }
                    }
                    i++;
                }
                Marshal.FreeHGlobal(ptrBuf);
                SetupDiDestroyDeviceInfoList(h);
            }
            return ans;
        }

Documentation: SetupDiGetDeviceInstanceId@msdn on MSDN