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

> Obtiene los grupos de iluminación en los que el dispositivo de entrada tiene lámparas controlables.

Obtiene los grupos de iluminación en los que el dispositivo de entrada tiene lámparas controlables.

## Sintaxis

```cpp theme={null}
GameInputLightingGroups GetSupportedLightingGroups();
```

### Parámetros

Este método no tiene parámetros.

### Valor devuelto

Tipo: [GameInputLightingGroups](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputlightinggroups)

Una combinación de marcas de `GameInputLightingGroups` para cada grupo de iluminación con nombre que contiene al menos una lámpara del dispositivo. Devuelve `GameInputLightingGroupUnknown` (0) si el dispositivo no tiene lámparas en ningún grupo con nombre.

## Comentarios

Cada marca del valor devuelto identifica un grupo de lámparas con nombre, como `GameInputLightingGroupFaceButtons` o `GameInputLightingGroupCenterLight`, al que puede dirigirse con [IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md). El método nunca notifica `GameInputLightingGroupUnknown` como grupo, porque su valor es 0.

Un dispositivo puede tener lámparas que no pertenecen a ningún grupo con nombre. Por lo tanto, un valor devuelto de 0 no siempre significa que el dispositivo no tenga lámparas. Para determinar si un dispositivo admite la iluminación, compruebe si [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) incluye `GameInputKindLighting`, o llame a [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.md) con `GameInputLightingGroupAll`. Para contar las lámparas que no están en un grupo con nombre, llame a `GetSupportedLightingGroupSize` con `GameInputLightingGroupUnknown`.

En el siguiente ejemplo se establecen en rojo los botones frontales y en azul la luz central en los dispositivos que tienen esos grupos, y luego se aplican los 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();
}
```

El conjunto de grupos de iluminación admitidos no cambia durante la vida útil del objeto de dispositivo.

> [!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)\
[GameInputLightingGroups](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputlightinggroups)\
[IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.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)\
[IGameInputDevice::ApplyLightingSystemDefault](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_applylightingsystemdefault.md)

## Historial de versiones

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


## Related topics

- [IGameInputDevice::GetSupportedLightingGroupSize](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroupsize.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)
- [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)
- [IGameInputDevice::GetDeviceFamily](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicefamily.md)