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

# Enumeración LampPurposes

> Enumeración de marcas que describe los propósitos previstos de una sola lámpara, como Control, Accent, Branding, Status, Illumination y Presentation.

# Enumeración LampPurposes

Describe un conjunto de propósitos para los que está previsto usar una sola lámpara.

## Sintaxis

```cpp theme={null}
enum class LampPurposes : uint32_t
{
    Undefined       = 0x00,
    Control         = 0x01,
    Accent          = 0x02,
    Branding        = 0x04,
    Status          = 0x08,
    Illumination    = 0x10,
    Presentation    = 0x20
}; 

DEFINE_ENUM_FLAG_OPERATORS(LampPurposes);
```

## Constantes

| Constante | Descripción |
| - | - |
| Undefined | Los LampPurposes no están especificados para esta lámpara. |
| Control | La lámpara está asociada a un control del dispositivo (por ejemplo, botón, tecla, control deslizante). |
| Accent | La lámpara se usa con fines de acento estético y no interactúa con el usuario (por ejemplo, LED de ventilador de la carcasa, paneles laterales iluminados de un teclado). |
| Branding | La lámpara se usa para la marca del dispositivo (por ejemplo, logotipo del fabricante). |
| Status | La lámpara se usa para indicar información de estado del sistema (por ejemplo, correo electrónico no leído, temperatura de la CPU). |
| Illumination | La lámpara ilumina un objeto que está fuera del LampArray (por ejemplo, foco de escenario, faros de coche, flash de cámara). |
| Presentation | Una lámpara que el usuario mira directamente (por ejemplo, dentro de una obra de arte o un disfraz). |

## Comentarios

Es probable que esta lista se amplíe en el futuro, así que evite usar comprobaciones de error que validen si un LampPurpose está dentro de los límites actuales. El enfoque preferido es comparar con el subconjunto de LampPurposes que admite la aplicación.

## Requisitos

**Encabezado:** declarado en LampArray.h.

## 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)\
[ILampArray::GetIndicesCountForPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes.md)\
[ILampArray::GetIndicesForPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)\
[ILampInfo::GetPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes.md)


## Related topics

- [Miembros de la API LampArray](https://docs.xbox.com/es/reference/lighting/lamparray/lamparray_members.md)
- [GetIndicesForPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)
- [GetIndicesCountForPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes.md)
- [GetPurposes](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes.md)
- [ILampArray (Contenido de la interfaz)](https://docs.xbox.com/es/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)