Pular para o conteúdo principal
Obtém o número de lâmpadas do dispositivo de entrada na seleção de grupos de iluminação especificada.

Sintaxe

Parâmetros

group
Tipo: GameInputLightingGroups
A seleção de grupos de iluminação cujas lâmpadas são contadas. Pode ser um ou mais sinalizadores de grupo nomeado, GameInputLightingGroupAll ou GameInputLightingGroupUnknown.

Valor retornado

Tipo: uint32_t O número de lâmpadas na seleção. Retorna 0 se o dispositivo não tiver lâmpadas na seleção ou se group contiver sinalizadores indefinidos.

Comentários

O valor de group é interpretado da seguinte maneira. A contagem de lâmpadas de uma seleção é o limite superior exclusivo do parâmetro groupOrderIndex de IGameInputDevice::SetLightingColor quando você endereça uma lâmpada individual pela sua posição ordinal. A exceção é GameInputLightingGroupKeyboardKey, que endereça lâmpadas individuais pelo código de verificação do teclado. O exemplo a seguir acende cada lâmpada do grupo de botões frontais com um tom diferente de verde.
As contagens de lâmpadas não mudam 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::GetSupportedLightingGroups
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors

Histórico de versões

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