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

> Envía todos los colores de iluminación preparados al dispositivo de entrada en una sola actualización.

Envía todos los colores de iluminación preparados al dispositivo de entrada en una sola actualización.

## Sintaxis

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

### Parámetros

Este método no tiene parámetros.

### Valor devuelto

Tipo: void

## Comentarios

Los colores que se establecen llamando a [IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md) solo se preparan; no cambian las lámparas hasta que se llama a `ApplyLightingColors`. Este método envía los colores preparados de cada lámpara al dispositivo en una sola escritura, de modo que los cambios en varios grupos o lámparas surten efecto al mismo tiempo.

Solo se actualizan las lámparas que tienen un color preparado. Si no hay colores preparados, la llamada no tiene ningún efecto.

Los colores preparados siguen en vigor después de aplicarse. Para cambiar un grupo más adelante, prepare el nuevo color para ese grupo y vuelva a llamar a `ApplyLightingColors`; los colores de las demás lámparas se conservan. Para descartar todos los colores preparados y devolver las lámparas a su comportamiento predeterminado, llame a [IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md).

Cuando el dispositivo se desconecta, sus colores preparados se descartan. Las llamadas en un dispositivo desconectado no tienen ningún efecto.

En el siguiente ejemplo se establecen en rojo los botones frontales de un mando y en azul su luz central, y luego se aplican ambos colores en una sola actualización.

```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 compatibilidad con la iluminación depende del dispositivo y de la plataforma. Actualmente, GameInput admite la iluminación en dispositivos con Iluminación dinámica de Windows (LampArray) y en la barra de luz de los mandos DualSense.

## Requisitos

**Encabezado:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)\
[IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)\
[IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/es/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)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v4** | Se introdujo. |


## Related topics

- [IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)
- [IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)
- [IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.md)
- [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md)
- [Uso de varias versiones de la API de GameInput en una aplicación](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-version-interop.md)