> ## 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 todas as cores de iluminação preparadas e retorna as lâmpadas do dispositivo de entrada ao comportamento padrão.

Descarta todas as cores de iluminação preparadas e retorna as lâmpadas do dispositivo de entrada ao comportamento padrão.

## Sintaxe

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

### Parâmetros

Este método não tem parâmetros.

### Valor retornado

Tipo: void

## Comentários

Chame este método quando o seu aplicativo não precisar mais controlar a iluminação de um dispositivo, por exemplo, quando o jogador sair de um modo de jogo que usa iluminação personalizada. Ele descarta todas as cores que foram preparadas chamando [IGameInputDevice::SetLightingColor](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md) e libera o controle das lâmpadas, de modo que elas retornem ao comportamento fornecido por padrão pelo sistema ou pelo dispositivo. Em dispositivos cujo protocolo não tem como retomar o comportamento padrão, as lâmpadas são desligadas.

Depois de chamar este método, você pode assumir o controle das lâmpadas novamente preparando novas cores e chamando [IGameInputDevice::ApplyLightingColors](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md).

O exemplo a seguir restaura a iluminação padrão de um dispositivo.

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

> [!NOTE]
>
> O suporte à iluminação depende do dispositivo e da plataforma. Atualmente, o GameInput oferece suporte à iluminação em dispositivos com Iluminação Dinâmica do Windows (LampArray) e na barra de luz dos controles DualSense.

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::SetLightingColor](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)\
[IGameInputDevice::ApplyLightingColors](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md)\
[GameInputLightingGroups](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputlightinggroups)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v4** | Introduzido. |


## Related topics

- [IGameInputDevice::ApplyLightingColors](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingcolors.md)
- [IGameInputDevice::SetLightingColor](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)
- [IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.md)
- [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md)
- [IGameInputDevice::GetSupportedSystemButtons](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedsystembuttons.md)