> ## 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 interfaz ILampArray > Interfaz COM que representa un periférico de iluminación RGB; expone propiedades del dispositivo como el número de lámparas, las dimensiones y los identificadores, y métodos para establecer el color y el brillo. # ILampArray Representa un dispositivo con iluminación RGB habilitada. Este objeto proporciona información sobre las propiedades físicas del dispositivo, como el número de lámparas, las dimensiones, el identificador del fabricante y el intervalo de actualización de las lámparas (similar a la frecuencia de actualización de una pantalla). ILampArray también expone métodos para cambiar el color y el brillo de las lámparas en el dispositivo. ## Sintaxis ```cpp theme={null} class ILampArray : public IUnknown ``` ## Métodos | Método | Descripción | | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | [GetBoundingBox](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox) | Devuelve el cuadro de límite 3D lógico que abarca el ILampArray. | | [GetBrightnessLevel](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getbrightnesslevel) | Obtiene el brillo general del LampArray. | | [GetDeviceId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid) | Devuelve el identificador generado por el sistema para el ILampArray. | | [GetHardwareVersion](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_gethardwareversion) | Recupera el número de versión de hardware de un ILampArray. | | [GetIndicesCountForPurposes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes) | Devuelve el número de índices de lámpara que admiten el conjunto especificado de LampPurposes. | | [GetIndicesForPurposes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes) | Rellena un búfer de índices de lámpara que admiten un conjunto especificado de LampPurposes. | | [GetIsEnabled](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getisenabled) | Obtiene el estado habilitado de un ILampArray para el proceso actual. | | [GetLampArrayKind](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind) | Devuelve el tipo de dispositivo físico representado por el ILampArray. | | [GetLampCount](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount) | Devuelve el número de lámparas que forman parte de este ILampArray. | | [GetLampInfo](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampinfo) | Devuelve un ILampInfo para la lámpara en el índice especificado. | | [GetMinUpdateIntervalInMicroseconds](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getminupdateintervalinmicroseconds) | Devuelve el intervalo mínimo en el que el dispositivo es capaz de actualizar el estado de sus lámparas, según lo notificado por el dispositivo. | | [GetProductId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid) | Recupera el identificador de producto de hardware de un ILampArray. | | [GetVendorId](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid) | Recupera el número de identificador de proveedor de hardware de un ILampArray. | | [SetBrightnessLevel](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setbrightnesslevel) | Establece el brillo general del ILampArray. | | [SetColor](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolor) | Establece el color de todas las lámparas del ILampArray. | | [SetColorsForIndices](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices) | Establece el color de una o varias lámparas. | | [SetColorsForScanCodes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes) | Establece el color de una o varias lámparas, correspondientes a códigos de digitalización de teclado. | | [SetIsEnabled](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled) | Establece el estado habilitado de un ILampArray para el proceso actual. | | [SupportsScanCodes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_supportsscancodes) | Devuelve si un LampArray admite el direccionamiento de lámparas mediante códigos de digitalización de teclado. | ## Comentarios Las aplicaciones pueden seguir manteniendo referencias a una instancia de ILampArray (de forma intencionada o no) después de que el dispositivo subyacente se haya desconectado del sistema. La instancia de ILampArray sigue siendo válida, ya que no se puede obligar a la aplicación a liberar su referencia a la interfaz, pero el objeto subyacente entra en un estado zombi. En estado zombi, todos los métodos de la interfaz ILampArray que devuelven información de configuración estática o información de estado del dispositivo siguen siendo invocables (en general, los métodos Get\*). Sin embargo, se omitirá cualquier método que modifique el color o el brillo de las lámparas en un dispositivo conectado. Si el mismo LampArray físico se vuelve a conectar posteriormente al sistema, el objeto de dispositivo zombi se restaura y todos los métodos de la instancia de ILampArray vuelven a ser funcionales. ## Requisitos **Encabezado:** LampArray.h **Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series ## Consulte también [Información general de la API de iluminación](/build/core-features/common/lighting/gc-lighting-toc)\ [Conceptos básicos de iluminación](/build/core-features/common/lighting/lighting-basics)\ [LampArray](/reference/lighting/lamparray/lamparray_members) ## Related topics - [Referencia de miembros de la API LampArray](/es/reference/lighting/lamparray/lamparray_members.md) - [Referencia de la interfaz ILampInfo](/es/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md) - [Referencia de la enumeración LampPurposes](/es/reference/lighting/lamparray/enums/lamppurposes.md) - [Referencia de la enumeración LampArrayKind](/es/reference/lighting/lamparray/enums/lamparraykind.md) - [Referencia de la estructura LampArrayColor](/es/reference/lighting/lamparray/structs/lamparraycolor.md)