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

> Obtiene el número de lámparas del dispositivo de entrada en la selección de grupos de iluminación especificada.

Obtiene el número de lámparas del dispositivo de entrada en la selección de grupos de iluminación especificada.

## Sintaxis

```cpp theme={null}
uint32_t GetSupportedLightingGroupSize(
    GameInputLightingGroups group
);
```

### Parámetros

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

La selección de grupos de iluminación cuyas lámparas se cuentan. Puede ser una o varias marcas de grupo con nombre, `GameInputLightingGroupAll` o `GameInputLightingGroupUnknown`.

### Valor devuelto

Tipo: uint32\_t

El número de lámparas de la selección. Devuelve 0 si el dispositivo no tiene lámparas en la selección o si *group* contiene marcas no definidas.

## Comentarios

El valor de *group* se interpreta de la siguiente manera.

| Valor de *group* | Lámparas contadas |
| - | - |
| `GameInputLightingGroupAll` | Todas las lámparas del dispositivo, incluidas las que no pertenecen a un grupo con nombre. |
| `GameInputLightingGroupUnknown` | Solo las lámparas que no pertenecen a ningún grupo con nombre. |
| Una o varias marcas de grupo con nombre | La suma del número de lámparas de cada grupo con nombre de la selección. |

El número de lámparas de una selección es el límite superior exclusivo del parámetro *groupOrderIndex* de [IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md) cuando se dirige a una lámpara individual por su ordinal. La excepción es `GameInputLightingGroupKeyboardKey`, que se dirige a las lámparas individuales por el código de exploración del teclado.

En el siguiente ejemplo se ilumina cada lámpara del grupo de botones frontales con un tono de verde diferente.

```cpp theme={null}
void SetFaceButtonGradient(IGameInputDevice* device) noexcept
{
    const uint32_t lampCount = device->GetSupportedLightingGroupSize(GameInputLightingGroupFaceButtons);
    for (uint32_t i = 0; i < lampCount; ++i)
    {
        const uint8_t green = static_cast<uint8_t>(255 * (i + 1) / lampCount);
        device->SetLightingColor({ 0, green, 0 }, GameInputLightingGroupFaceButtons, i);
    }

    device->ApplyLightingColors();
}
```

El número de lámparas 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::GetSupportedLightingGroups](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.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)

## Historial de versiones

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


## Related topics

- [IGameInputDevice::GetSupportedLightingGroups](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedlightinggroups.md)
- [IGameInputDevice::SetLightingColor](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setlightingcolor.md)
- [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)
- [IGameInputDevice::GetSupportedRumbleMotors](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedrumblemotors.md)
- [IGameInputDevice::GetSupportedSystemButtons](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedsystembuttons.md)