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

# IGameInputDevice::ApplyLightingColors

> Envoie au périphérique d'entrée toutes les couleurs d'éclairage préparées en une seule mise à jour.

Envoie au périphérique d'entrée toutes les couleurs d'éclairage préparées en une seule mise à jour.

## Syntaxe

```cpp theme={null}
void ApplyLightingColors();
```

### Paramètres

Cette méthode n'a aucun paramètre.

### Valeur de retour

Type : void

## Remarques

Les couleurs que vous définissez en appelant [IGameInputDevice::SetLightingColor](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md) sont seulement préparées; elles ne modifient pas les lampes tant que vous n'avez pas appelé `ApplyLightingColors`. Cette méthode envoie les couleurs préparées de chaque lampe au périphérique en une seule écriture, de sorte que les modifications apportées à plusieurs groupes ou lampes prennent effet en même temps.

Seules les lampes ayant une couleur préparée sont mises à jour. Si aucune couleur n'est préparée, l'appel n'a aucun effet.

Les couleurs préparées restent en vigueur après leur application. Pour modifier un groupe plus tard, préparez la nouvelle couleur de ce groupe et appelez de nouveau `ApplyLightingColors`; les couleurs des autres lampes sont conservées. Pour abandonner toutes les couleurs préparées et rétablir le comportement par défaut des lampes, appelez [IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md).

Lorsque le périphérique se déconnecte, ses couleurs préparées sont abandonnées. Les appels effectués sur un périphérique déconnecté n'ont aucun effet.

L'exemple suivant définit les boutons frontaux d'une manette en rouge et son voyant central en bleu, puis applique les deux couleurs en une seule mise à jour.

```cpp theme={null}
void SetControllerLighting(IGameInputDevice* device) noexcept
{
    const GameInputLightingGroups groups = device->GetSupportedLightingGroups();

    if ((groups & GameInputLightingGroupFaceButtons) != 0)
    {
        device->SetLightingColor({ 255, 0, 0 }, GameInputLightingGroupFaceButtons);
    }

    if ((groups & GameInputLightingGroupCenterLight) != 0)
    {
        device->SetLightingColor({ 0, 0, 255 }, GameInputLightingGroupCenterLight);
    }

    device->ApplyLightingColors();
}
```

> [!NOTE]
>
> La prise en charge de l'éclairage dépend du périphérique et de la plateforme. Actuellement, GameInput prend en charge l'éclairage sur les périphériques Windows Dynamic Lighting (LampArray) et sur la barre lumineuse des manettes DualSense.

## Configuration requise

**En-tête :** GameInput.h

**Bibliothèque :** gameinput.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::SetLightingColor](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)\
[IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)\
[IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.md)\
[GameInputColor](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/structs/gameinputcolor)\
[GameInputLightingGroups](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputlightinggroups)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduit. |


## Related topics

- [IGameInputDevice::SetLightingColor](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)
- [IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)
- [IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.md)
- [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md)
- [Utilisation de plusieurs versions de l'API GameInput dans une même application](https://docs.xbox.com/fr-CA/build/core-features/common/input/overviews/input-version-interop.md)