> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de la API de iluminación para periféricos LampArray

> Referencia de la API de iluminación del GDK para enumerar periféricos LampArray como teclados, mouse y auriculares, y controlar su iluminación RGB.

# Referencia de la API de iluminación

Material de referencia de la API de iluminación para Microsoft Game Development Kit (GDK). Use estas API para enumerar periféricos LampArray compatibles (teclados, mouse, auriculares y otros dispositivos de iluminación HID) y controlar su iluminación RGB.

## Enumerar periféricos compatibles

Para detectar periféricos compatibles, registre una devolución de llamada de estado que la API de LampArray invoca para cada dispositivo conectado y de nuevo cada vez que se conecta o se quita un dispositivo.

1. Implemente una función [LampArrayStatusCallback](/reference/lighting/lamparray/functions/lamparraystatuscallback) para recibir eventos de conexión y desconexión de dispositivos.
2. Llame a [RegisterLampArrayStatusCallback](/reference/lighting/lamparray/functions/registerlamparraystatuscallback) para registrar la devolución de llamada. Pase un valor de [LampArrayEnumerationKind](/reference/lighting/lamparray/enums/lamparrayenumerationkind) para controlar si la enumeración inicial se ejecuta de forma asincrónica o se bloquea hasta que se haya notificado cada dispositivo conectado.
3. En la devolución de llamada, inspeccione la instancia de [ILampArray](/reference/lighting/lamparray/interfaces/ilamparray/ilamparray) para leer las propiedades del dispositivo, como [DeviceId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid), [LampArrayKind](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind), [LampCount](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount), [VendorId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid) y [ProductId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid).
4. Cuando ya no necesite notificaciones, llame a [UnregisterLampArrayCallback](/reference/lighting/lamparray/functions/unregisterlamparraycallback) para dejar de recibir eventos.

Para ver un tutorial completo con código de ejemplo, consulte [Conceptos básicos de LampArray](/build/core-features/common/lighting/lighting-basics).

## En esta sección

[LampArray](/reference/lighting/lamparray/lamparray_members)<br />Miembros de la API de LampArray, incluidas las funciones, interfaces, enumeraciones y estructuras que se usan para enumerar dispositivos y controlar la iluminación.

## Consulte también

[Información general de la API de iluminación](/build/core-features/common/lighting/gc-lighting-toc)


## Related topics

- [Referencia de miembros de la API LampArray](/es/reference/lighting/lamparray/lamparray_members.md)
- [Referencia de la interfaz ILampArray](/es/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [Referencia de la función LampArrayCallback](/es/reference/lighting/lamparray/functions/lamparraycallback.md)
- [Referencia de la función LampArrayStatusCallback](/es/reference/lighting/lamparray/functions/lamparraystatuscallback.md)
- [API de iluminación y LampArray en XBOX y PC](/es/build/core-features/common/lighting/index.md)