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

# Referencia de la API de iluminación (contenido de la API)

> 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](https://docs.xbox.com/es/reference/lighting/lamparray/functions/lamparraystatuscallback.md) para recibir eventos de conexión y desconexión de dispositivos.
2. Llame a [RegisterLampArrayStatusCallback](https://docs.xbox.com/es/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md) para registrar la devolución de llamada. Pase un valor de [LampArrayEnumerationKind](https://docs.xbox.com/es/reference/lighting/lamparray/enums/lamparrayenumerationkind.md) 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](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md) para leer las propiedades del dispositivo, como [DeviceId](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid.md), [LampArrayKind](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind.md), [LampCount](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount.md), [VendorId](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid.md) y [ProductId](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid.md).
4. Cuando ya no necesite notificaciones, llame a [UnregisterLampArrayCallback](https://docs.xbox.com/es/reference/lighting/lamparray/functions/unregisterlamparraycallback.md) para dejar de recibir eventos.

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

## En esta sección

[LampArray](https://docs.xbox.com/es/reference/lighting/lamparray/lamparray_members.md)\
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](https://docs.xbox.com/es/build/core-features/common/lighting/gc-lighting-toc.md)


## Related topics

- [Referencia de API (contenido)](https://docs.xbox.com/es/reference/gc-reference-toc.md)
- [Información general de la iluminación](https://docs.xbox.com/es/build/core-features/common/lighting/gc-lighting-toc.md)
- [ILampArray (Contenido de la interfaz)](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)
- [ILampInfo (Contenido de la interfaz)](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [Referencia de la API de chat (contenido)](https://docs.xbox.com/es/reference/chat/gc-reference-chat-toc.md)