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

# Référence de l'é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é.

<a id="syntaxSection" />

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

<a id="constantsSection" />

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

<a id="remarksSection" />

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

<a id="requirementsSection" />

## Configuration requise

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

<a id="seealsoSection" />

## Voir aussi

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


## Related topics

- [Référence de l'énumération LampArrayEnumerationKind](/fr/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [Référence de l'énumération LampArrayStatus](/fr/reference/lighting/lamparray/enums/lamparraystatus.md)
- [Référence de l'énumération LampArrayKind](/fr/reference/lighting/lamparray/enums/lamparraykind.md)
- [Référence des membres de l'API LampArray](/fr/reference/lighting/lamparray/lamparray_members.md)
- [Méthode ILampArray::GetIndicesForPurposes](/fr/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes.md)