DeviceInterfaces

A small .NET Framework class library that wraps Win32 device-management APIs for Windows desktop applications. It currently provides USB device arrival and removal notifications for a window.

• .NET Framework 4.8
• Windows, with a window handle available (WinForms, WPF via HwndSource, or any HWND)

The project uses the legacy (non-SDK) MSBuild format, so build it with Visual Studio or MSBuild rather than the dotnet CLI:

msbuild DeviceInterfaces.sln -p:Configuration=Release

The compiled DeviceInterfaces.dll and its DeviceInterfaces.xml documentation file are written to bin\Release\ and copied to bin\ at the solution root. Keep the XML file beside the DLL wherever the assembly is referenced — it is what supplies IntelliSense.

USBDeviceNotification registers a window with Windows; the window itself receives the resulting messages, so the host application handles them in its own window procedure.

1. Register a window handle and keep the returned notification handle.
2. Watch for WM_DEVICECHANGE and compare wParam against the exposed constants.
3. Unregister with the stored handle during teardown.

using System;
using System.Windows.Forms;
using DeviceInterfaces;

public class MainForm : Form
{
    private IntPtr m_pNotificationHandle = IntPtr.Zero;

    protected override void OnHandleCreated(EventArgs e)
    {
        base.OnHandleCreated(e);
        m_pNotificationHandle = USBDeviceNotification.RegisterUsbDeviceNotification(Handle);
    }

    protected override void OnHandleDestroyed(EventArgs e)
    {
        USBDeviceNotification.UnregisterUsbDeviceNotification(m_pNotificationHandle);
        m_pNotificationHandle = IntPtr.Zero;
        base.OnHandleDestroyed(e);
    }

    protected override void WndProc(ref Message m)
    {
        if (m.Msg == USBDeviceNotification.iWM_DEVICECHANGE)
        {
            switch ((int)m.WParam)
            {
                case USBDeviceNotification.iDEVICE_CONNECTED:
                    // A USB device was connected
                    break;

                case USBDeviceNotification.iDEVICE_REMOVED:
                    // A USB device was removed
                    break;
            }
        }

        base.WndProc(ref m);
    }
}

Notifications are filtered to the USB device interface class (A5DCBF10-6530-11D2-901F-00C04FB951ED), so the window is notified about USB devices only.

Tagged releases are published on the releases page with the compiled assembly attached. See docs/RELEASING.md for the release process.

Released under the MIT License.