> ## 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.

# ILampArray (Contenido de la interfaz)

> 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](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md) | Devuelve el cuadro de límite 3D lógico que abarca el ILampArray. |
| [GetBrightnessLevel](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getbrightnesslevel.md) | Obtiene el brillo general del LampArray. |
| [GetDeviceId](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid.md) | Devuelve el identificador generado por el sistema para el ILampArray. |
| [GetHardwareVersion](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_gethardwareversion.md) | Recupera el número de versión de hardware de un ILampArray. |
| [GetIndicesCountForPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes.md) | Devuelve el número de índices de lámpara que admiten el conjunto especificado de LampPurposes. |
| [GetIndicesForPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md) | Rellena un búfer de índices de lámpara que admiten un conjunto especificado de LampPurposes. |
| [GetIsEnabled](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getisenabled.md) | Obtiene el estado habilitado de un ILampArray para el proceso actual. |
| [GetLampArrayKind](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind.md) | Devuelve el tipo de dispositivo físico representado por el ILampArray. |
| [GetLampCount](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount.md) | Devuelve el número de lámparas que forman parte de este ILampArray. |
| [GetLampInfo](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampinfo.md) | Devuelve un ILampInfo para la lámpara en el índice especificado. |
| [GetMinUpdateIntervalInMicroseconds](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getminupdateintervalinmicroseconds.md) | 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](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid.md) | Recupera el identificador de producto de hardware de un ILampArray. |
| [GetVendorId](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid.md) | Recupera el número de identificador de proveedor de hardware de un ILampArray. |
| [SetBrightnessLevel](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setbrightnesslevel.md) | Establece el brillo general del ILampArray. |
| [SetColor](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolor.md) | Establece el color de todas las lámparas del ILampArray. |
| [SetColorsForIndices](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md) | Establece el color de una o varias lámparas. |
| [SetColorsForScanCodes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforscancodes.md) | Establece el color de una o varias lámparas, correspondientes a códigos de digitalización de teclado. |
| [SetIsEnabled](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setisenabled.md) | Establece el estado habilitado de un ILampArray para el proceso actual. |
| [SupportsScanCodes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_supportsscancodes.md) | 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](https://docs.xbox.com/es/build/core-features/common/lighting/gc-lighting-toc.md)\
[Conceptos básicos de iluminación](https://docs.xbox.com/es/build/core-features/common/lighting/lighting-basics.md)\
[LampArray](https://docs.xbox.com/es/reference/lighting/lamparray/lamparray_members.md)


## Related topics

- [ILampInfo (Contenido de la interfaz)](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [Miembros de la API LampArray](https://docs.xbox.com/es/reference/lighting/lamparray/lamparray_members.md)
- [IDStorageStatusArrayX (Contenido de la interfaz)](https://docs.xbox.com/es/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx.md)
- [IDStorageFactoryX (Contenido de la interfaz)](https://docs.xbox.com/es/reference/system/dstorage/interfaces/IDStorageFactoryX/idstoragefactoryx.md)
- [Referencia de la API de iluminación (contenido de la API)](https://docs.xbox.com/es/reference/lighting/gc-reference-lighting-toc.md)
