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

<a id="syntaxSection" />

## 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);
```

<a id="constantsSection" />

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

<a id="remarksSection" />

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

<a id="requirementsSection" />

## Requisitos

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

<a id="seealsoSection" />

## Consulte también

[Información general de la API de iluminación](/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetIndicesCountForPurposes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes)\
[ILampArray::GetIndicesForPurposes](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes)\
[ILampInfo::GetPurposes](/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes)


## 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 enumeración LampArrayStatus](/es/reference/lighting/lamparray/enums/lamparraystatus.md)
- [Referencia de la enumeración LampArrayKind](/es/reference/lighting/lamparray/enums/lamparraykind.md)
- [Referencia de la enumeración LampArrayEnumerationKind](/es/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)