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

# Referência da enumeração LampPurposes

> Enumeração de sinalizadores que descreve as finalidades pretendidas de uma única Lamp, como Control, Accent, Branding, Status, Illumination e Presentation.

# Enumeração LampPurposes

Descreve um conjunto de finalidades para as quais uma única Lamp se destina.

<a id="syntaxSection" />

## Sintaxe

```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 | Descrição |
| - | - |
| Undefined | LampPurposes não estão especificados para esta Lamp. |
| Control | A Lamp está associada a um controle no dispositivo (por exemplo, botão, tecla, controle deslizante). |
| Accent | A Lamp é usada para fins estéticos de destaque e não interage com o usuário (por exemplo, LED da ventoinha do gabinete, painéis laterais iluminados em um teclado). |
| Branding | A Lamp é usada para a identidade visual do dispositivo (por exemplo, logotipo do fabricante). |
| Status | A Lamp é usada para indicar informações de status do sistema (por exemplo, email não lido, temperatura da CPU). |
| Illumination | A Lamp ilumina um objeto que está fora do LampArray (por exemplo, holofote de palco, faróis de carro, flash de câmera). |
| Presentation | Uma lâmpada para a qual o usuário olha diretamente (por exemplo, dentro de uma obra de arte ou fantasia). |

<a id="remarksSection" />

## Comentários

É provável que esta lista seja expandida no futuro, portanto evite usar verificações de erro que validem se um LampPurpose está dentro dos limites atuais. A abordagem preferencial é comparar com o subconjunto de LampPurposes compatíveis com o aplicativo.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** declarado em LampArray.h.

<a id="seealsoSection" />

## Confira também

[Visão geral da API de iluminação](/pt-BR/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetIndicesCountForPurposes](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes)\
[ILampArray::GetIndicesForPurposes](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes)\
[ILampInfo::GetPurposes](/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes)


## Related topics

- [Referência da enumeração LampArrayStatus](/pt-BR/reference/lighting/lamparray/enums/lamparraystatus.md)
- [Referência da enumeração LampArrayKind](/pt-BR/reference/lighting/lamparray/enums/lamparraykind.md)
- [Referência da enumeração LampArrayEnumerationKind](/pt-BR/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [Referência de membros da API LampArray](/pt-BR/reference/lighting/lamparray/lamparray_members.md)
- [Referência da interface ILampArray](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)