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

> Descarta todos los colores de iluminación preparados y devuelve las lámparas del dispositivo de entrada a su comportamiento predeterminado.

Descarta todos los colores de iluminación preparados y devuelve las lámparas del dispositivo de entrada a su comportamiento predeterminado.

## Sintaxis

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

### Parámetros

Este método no tiene parámetros.

### Valor devuelto

Tipo: void

## Comentarios

Llame a este método cuando la aplicación ya no necesite controlar la iluminación de un dispositivo, por ejemplo, cuando el jugador sale de un modo de juego que usa iluminación personalizada. Descarta todos los colores que se prepararon llamando a [IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md) y libera el control de las lámparas, de modo que vuelvan al comportamiento que el sistema o el dispositivo proporcionan de forma predeterminada. En los dispositivos cuyo protocolo no permite reanudar el comportamiento predeterminado, las lámparas se apagan.

Después de llamar a este método, puede volver a tomar el control de las lámparas preparando nuevos colores y llamando a [IGameInputDevice::ApplyLightingColors](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md).

En el siguiente ejemplo se restaura la iluminación predeterminada de un dispositivo.

```cpp theme={null}
void RestoreDefaultLighting(IGameInputDevice* device) noexcept
{
    if ((device->GetSupportedInput() & GameInputKindLighting) != 0)
    {
        device->ApplyLightingSystemDefault();
    }
}
```

> [!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::ApplyLightingColors](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md)\
[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::ApplyLightingColors](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md)
- [IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.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)
- [IGameInputDevice::GetSupportedSystemButtons](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedsystembuttons.md)