> ## 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'une seule Lamp, comme Control, Accent, Branding, Status, Illumination et Presentation.

# Énumération LampPurposes

Décrit un ensemble d'usages auxquels une seule Lamp est destinée.

<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 cette Lamp. |
| Control | La Lamp est associée à une commande de l'appareil (par exemple, bouton, touche, curseur). |
| Accent | La Lamp est utilisée à des fins esthétiques et n'interagit pas avec l'utilisateur (par exemple, DEL de ventilateur de boîtier, panneaux latéraux éclairés d'un clavier). |
| Branding | La Lamp est utilisée pour l'image de marque de l'appareil (par exemple, logo du fabricant). |
| Status | La Lamp est utilisée pour indiquer des informations sur l'état du système (par exemple, courriel non lu, température du processeur). |
| Illumination | La Lamp éclaire un objet situé à l'extérieur du LampArray (par exemple, projecteur de scène, phares de voiture, flash d'appareil photo). |
| Presentation | Une lampe que l'utilisateur regarde directement (par exemple, dans une œuvre d'art ou un costume). |

<a id="remarksSection" />

## Remarques

Il est probable que cette liste s'allonge à l'avenir; évitez donc d'utiliser des vérifications d'erreur qui valident si un LampPurpose se situe dans les limites actuelles. L'approche recommandée consiste à effectuer la comparaison avec le sous-ensemble de LampPurposes que l'application prend en charge.

<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-CA/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetIndicesCountForPurposes](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes)\
[ILampArray::GetIndicesForPurposes](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicesforpurposes)\
[ILampInfo::GetPurposes](/fr-CA/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes)


## Related topics

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