Skip to main content

Lighting API Reference

Lighting API reference material for the Microsoft Game Development Kit (GDK). Use these APIs to enumerate compatible LampArray peripherals (keyboards, mice, headsets, and other HID lighting devices) and control their RGB lighting.

Enumerate compatible peripherals

To discover compatible peripherals, register a status callback that the LampArray API invokes for each connected device, and again whenever a device is attached or removed.
  1. Implement a LampArrayStatusCallback function to receive device connect and disconnect events.
  2. Call RegisterLampArrayStatusCallback to register the callback. Pass a LampArrayEnumerationKind value to control whether initial enumeration runs asynchronously or blocks until every connected device has been reported.
  3. In the callback, inspect the ILampArray instance to read device properties such as DeviceId, LampArrayKind, LampCount, VendorId, and ProductId.
  4. When you no longer need notifications, call UnregisterLampArrayCallback to stop receiving events.
For a complete walkthrough with sample code, see LampArray basics.

In this section

LampArray
LampArray API members, including the functions, interfaces, enums, and structs used to enumerate devices and control lighting.

See also

Lighting API Overview
Last modified on August 7, 2026