Pular para o conteúdo principal
Obtém os grupos de iluminação nos quais o dispositivo de entrada tem lâmpadas controláveis.

Sintaxe

Parâmetros

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

Valor retornado

Tipo: GameInputLightingGroups Uma combinação de sinalizadores GameInputLightingGroups para cada grupo de iluminação nomeado que contém pelo menos uma lâmpada no dispositivo. Retorna GameInputLightingGroupUnknown (0) se o dispositivo não tiver lâmpadas em nenhum grupo nomeado.

Comentários

Cada sinalizador no valor retornado identifica um grupo nomeado de lâmpadas, como GameInputLightingGroupFaceButtons ou GameInputLightingGroupCenterLight, que você pode endereçar com IGameInputDevice::SetLightingColor. O método nunca relata GameInputLightingGroupUnknown como um grupo, pois o valor dele é 0. Um dispositivo pode ter lâmpadas que não pertencem a nenhum grupo nomeado. Portanto, um valor retornado igual a 0 nem sempre significa que o dispositivo não tem lâmpadas. Para determinar se um dispositivo oferece suporte à iluminação, verifique se IGameInputDevice::GetSupportedInput inclui GameInputKindLighting ou chame IGameInputDevice::GetSupportedLightingGroupSize com GameInputLightingGroupAll. Para contar as lâmpadas que não estão em um grupo nomeado, chame GetSupportedLightingGroupSize com GameInputLightingGroupUnknown. O exemplo a seguir define os botões frontais como vermelhos e a luz central como azul em dispositivos que têm esses grupos e, em seguida, aplica as cores em uma única atualização.
O conjunto de grupos de iluminação com suporte não muda durante o tempo de vida do objeto de dispositivo.
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
IGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroupSize
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors
IGameInputDevice::ApplyLightingSystemDefault

Histórico de versões

Última modificação em 6 de novembro de 2026