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

# Énumération LampPurposes

> Énumération d'indicateurs décrivant les usages prévus d'un Lamp individuel, tels que Control, Accent, Branding, Status, Illumination et Presentation.

# Énumération LampPurposes

Décrit un ensemble d'usages auxquels un Lamp individuel est destiné.

## Syntaxe

```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 | Description |
| - | - |
| Undefined | Les LampPurposes ne sont pas spécifiés pour ce Lamp. |
| Control | Le Lamp est associé à une commande du périphérique (par exemple, bouton, touche, curseur). |
| Accent | Le Lamp est utilisé à des fins esthétiques et n'interagit pas avec l'utilisateur (par exemple, LED de ventilateur de boîtier, panneaux latéraux lumineux d'un clavier). |
| Branding | Le Lamp est utilisé pour l'image de marque du périphérique (par exemple, logo du fabricant). |
| Status | Le Lamp est utilisé pour indiquer des informations d'état du système (par exemple, courrier non lu, température du processeur). |
| Illumination | Le Lamp éclaire un objet situé en dehors du LampArray (par exemple, projecteur de scène, phares de voiture, flash d'appareil photo). |
| Presentation | Un Lamp que l'utilisateur regarde directement (par exemple, au sein d'une œuvre d'art ou d'un costume). |

## Remarques

Cette liste est susceptible de s'allonger à l'avenir ; évitez donc d'utiliser des vérifications d'erreurs qui valident si un LampPurpose se trouve dans les limites actuelles. L'approche recommandée consiste à effectuer la comparaison avec le sous-ensemble de LampPurposes pris en charge par l'application.

## Configuration requise

**En-tête :** déclaré dans LampArray.h.

## Voir aussi

[Vue d'ensemble de l'API d'éclairage](https://docs.xbox.com/fr/build/core-features/common/lighting/gc-lighting-toc.md)\
[ILampArray::GetIndicesCountForPurposes](https://docs.xbox.com/fr/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes.md)\
[ILampArray::GetIndicesForPurposes](https://docs.xbox.com/fr/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)\
[ILampInfo::GetPurposes](https://docs.xbox.com/fr/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes.md)


## Related topics

- [Membres de l'API LampArray](https://docs.xbox.com/fr/reference/lighting/lamparray/lamparray_members.md)
- [GetIndicesForPurposes](https://docs.xbox.com/fr/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)
- [GetIndicesCountForPurposes](https://docs.xbox.com/fr/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes.md)
- [GetPurposes](https://docs.xbox.com/fr/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes.md)
- [ILampArray (contenu de l'interface)](https://docs.xbox.com/fr/reference/lighting/lamparray/interfaces/ilamparray/ilamparray.md)