/// <summary>
/// Creates a virtual device node (hardware ID) in the provided device class.
/// </summary>
/// <param name="className">The device class name.</param>
/// <param name="classGuid">The GUID of the device class.</param>
/// <param name="node">The node path terminated by two null characters.</param>
/// <returns>True on success, false otherwise.</returns>
public static bool Create(string className, Guid classGuid, string node)
{
var deviceInfoSet = (IntPtr)(-1);
var deviceInfoData = new SetupApiWrapper.SP_DEVINFO_DATA();
try
{
deviceInfoSet = SetupApiWrapper.SetupDiCreateDeviceInfoList(ref classGuid, IntPtr.Zero);
if (deviceInfoSet == (IntPtr)(-1))
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
deviceInfoData.cbSize = Marshal.SizeOf(deviceInfoData);
if (!SetupApiWrapper.SetupDiCreateDeviceInfo(
deviceInfoSet,
className,
ref classGuid,
null,
IntPtr.Zero,
SetupApiWrapper.DICD_GENERATE_ID,
ref deviceInfoData
))
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
if (!SetupApiWrapper.SetupDiSetDeviceRegistryProperty(
deviceInfoSet,
ref deviceInfoData,
SetupApiWrapper.SPDRP_HARDWAREID,
node,
node.Length * 2
))
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
if (!SetupApiWrapper.SetupDiCallClassInstaller(
SetupApiWrapper.DIF_REGISTERDEVICE,
deviceInfoSet,
ref deviceInfoData
))
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
}
finally
{
if (deviceInfoSet != (IntPtr)(-1))
{
SetupApiWrapper.SetupDiDestroyDeviceInfoList(deviceInfoSet);
}
}
return(true);
}
/// <summary>
/// Searches for devices matching the provided class GUID and returns the device path and instance ID.
/// </summary>
/// <param name="target">The class GUID to enumerate.</param>
/// <param name="path">The device path of the enumerated device.</param>
/// <param name="instanceId">The instance ID of the enumerated device.</param>
/// <param name="instance">Optional instance ID (zero-based) specifying the device to process on multiple matches.</param>
/// <returns>True if at least one device was found with the provided class, false otherwise.</returns>
public static bool Find(Guid target, out string path, out string instanceId, int instance = 0)
{
var detailDataBuffer = IntPtr.Zero;
var deviceInfoSet = IntPtr.Zero;
try
{
SetupApiWrapper.SP_DEVINFO_DATA deviceInterfaceData = new SetupApiWrapper.SP_DEVINFO_DATA(),
da = new SetupApiWrapper.SP_DEVINFO_DATA();
int bufferSize = 0, memberIndex = 0;
deviceInfoSet = SetupApiWrapper.SetupDiGetClassDevs(ref target, IntPtr.Zero, IntPtr.Zero,
SetupApiWrapper.DIGCF_PRESENT | SetupApiWrapper.DIGCF_DEVICEINTERFACE);
deviceInterfaceData.cbSize = da.cbSize = Marshal.SizeOf(deviceInterfaceData);
while (SetupApiWrapper.SetupDiEnumDeviceInterfaces(deviceInfoSet, IntPtr.Zero, ref target, memberIndex,
ref deviceInterfaceData))
{
SetupApiWrapper.SetupDiGetDeviceInterfaceDetail(deviceInfoSet, ref deviceInterfaceData, IntPtr.Zero,
0,
ref bufferSize, ref da);
{
detailDataBuffer = Marshal.AllocHGlobal(bufferSize);
Marshal.WriteInt32(detailDataBuffer,
IntPtr.Size == 4 ? 4 + Marshal.SystemDefaultCharSize : 8);
if (SetupApiWrapper.SetupDiGetDeviceInterfaceDetail(deviceInfoSet, ref deviceInterfaceData,
detailDataBuffer,
bufferSize, ref bufferSize, ref da))
{
var pDevicePathName = detailDataBuffer + 4;
path = (Marshal.PtrToStringAuto(pDevicePathName) ?? string.Empty).ToUpper();
if (memberIndex == instance)
{
var nBytes = 256;
var ptrInstanceBuf = Marshal.AllocHGlobal(nBytes);
SetupApiWrapper.CM_Get_Device_ID(da.DevInst, ptrInstanceBuf, (uint)nBytes, 0);
instanceId = (Marshal.PtrToStringAuto(ptrInstanceBuf) ?? string.Empty).ToUpper();
Marshal.FreeHGlobal(ptrInstanceBuf);
return(true);
}
}
else
{
Marshal.FreeHGlobal(detailDataBuffer);
}
}
memberIndex++;
}
}
finally
{
if (deviceInfoSet != IntPtr.Zero)
{
SetupApiWrapper.SetupDiDestroyDeviceInfoList(deviceInfoSet);
}
}
path = instanceId = string.Empty;
return(false);
}
/// <summary>
/// Removed a device node identified by class GUID, path and instance ID.
/// </summary>
/// <param name="classGuid">The device class GUID.</param>
/// <param name="instanceId">The instance ID.</param>
/// <param name="rebootRequired">True if a reboot is required to complete the uninstall action, false otherwise.</param>
/// <returns>True on success, false otherwise.</returns>
public static bool Remove(Guid classGuid, string instanceId, out bool rebootRequired)
{
var deviceInfoSet = IntPtr.Zero;
var installParams = Marshal.AllocHGlobal(584); // Max struct size on x64 platform
try
{
var deviceInfoData = new SetupApiWrapper.SP_DEVINFO_DATA();
deviceInfoData.cbSize = Marshal.SizeOf(deviceInfoData);
deviceInfoSet = SetupApiWrapper.SetupDiGetClassDevs(
ref classGuid,
IntPtr.Zero,
IntPtr.Zero,
SetupApiWrapper.DIGCF_PRESENT | SetupApiWrapper.DIGCF_DEVICEINTERFACE
);
if (SetupApiWrapper.SetupDiOpenDeviceInfo(
deviceInfoSet,
instanceId,
IntPtr.Zero,
0,
ref deviceInfoData
))
{
var props = new SetupApiWrapper.SP_REMOVEDEVICE_PARAMS
{
ClassInstallHeader = new SetupApiWrapper.SP_CLASSINSTALL_HEADER()
};
props.ClassInstallHeader.cbSize = Marshal.SizeOf(props.ClassInstallHeader);
props.ClassInstallHeader.InstallFunction = SetupApiWrapper.DIF_REMOVE;
props.Scope = SetupApiWrapper.DI_REMOVEDEVICE_GLOBAL;
props.HwProfile = 0x00;
// Prepare class (un-)installer
if (SetupApiWrapper.SetupDiSetClassInstallParams(
deviceInfoSet,
ref deviceInfoData,
ref props,
Marshal.SizeOf(props)
))
{
// Invoke class installer with uninstall action
if (!SetupApiWrapper.SetupDiCallClassInstaller(SetupApiWrapper.DIF_REMOVE, deviceInfoSet,
ref deviceInfoData))
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
// Fill cbSize field
Marshal.WriteInt32(
installParams,
0, // cbSize is first field, always 32 bits long
IntPtr.Size == 4 ? 556 /* x86 size */ : 584 /* x64 size */
);
// Fill SP_DEVINSTALL_PARAMS struct
if (!SetupApiWrapper.SetupDiGetDeviceInstallParams(deviceInfoSet, ref deviceInfoData,
installParams))
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
// Grab Flags field of SP_DEVINSTALL_PARAMS (offset of 32 bits)
var flags = Marshal.ReadInt32(installParams, Marshal.SizeOf(typeof(uint)));
// Test for restart/reboot flags being present
rebootRequired = (flags & SetupApiWrapper.DI_NEEDRESTART) != 0 ||
(flags & SetupApiWrapper.DI_NEEDREBOOT) != 0;
return(true);
}
else
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
}
else
{
throw new Win32Exception(Marshal.GetLastWin32Error());
}
}
finally
{
if (deviceInfoSet != IntPtr.Zero)
{
SetupApiWrapper.SetupDiDestroyDeviceInfoList(deviceInfoSet);
}
Marshal.FreeHGlobal(installParams);
}
}