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

Sintaxis

Parámetros

Este método no tiene parámetros.

Valor devuelto

Tipo: 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. 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 incluye GameInputKindLighting, o llame a IGameInputDevice::GetSupportedLightingGroupSize 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.
El conjunto de grupos de iluminación admitidos no cambia durante la vida útil del objeto de dispositivo.
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
IGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault

Historial de versiones

Última modificación el 6 de noviembre de 2026