Technical Reference¶
Every layer of HIDMaestro from the C# SDK down to the kernel-side HID stack. Read the first five in order for the full picture.
- Architecture Overview: the stack diagram from SDK to driver, per-controller WUDFHost processes, and the three architecture groups.
- UMDF2 Driver Internals:
driver.c, the IOCTL dispatch table, the device context, and the event-driven worker. - XUSB Companion: how Xbox-family profiles get XInput without a kernel driver.
- SwDevice and PnP: device creation, container IDs, and the XInput slot-0 story.
- Shared Memory Protocol: the three sections per controller, the seqlock, and the named events.
- Cross-API Coverage: how DirectInput, XInput, SDL3/HIDAPI, the browser Gamepad API, and WGI are each satisfied.
- Multi-Controller: verified mixed-type operation and per-API ordering.
- Lifecycle and Teardown: create paths, removal ordering, and round-trip latencies by archetype.
- Driver Install and Signing: the embedded payload, certificate generation, and the idempotent install.
- Build and Release: the two-phase build and the release recipe.
- Testing and Verification:
scripts/verify.pyand the 46-scenario regression battery. - References: authoritative sources for every load-bearing claim in these docs.