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

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

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

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


## Related topics

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