Passer au contenu principal
Obtient le nombre de lampes du périphérique d’entrée dans la sélection de groupes d’éclairage spécifiée.

Syntaxe

Paramètres

group
Type : GameInputLightingGroups
Sélection de groupes d’éclairage dont les lampes sont comptées. Il peut s’agir d’un ou de plusieurs indicateurs de groupe nommé, de GameInputLightingGroupAll ou de GameInputLightingGroupUnknown.

Valeur de retour

Type : uint32_t Nombre de lampes dans la sélection. Retourne 0 si le périphérique n’a aucune lampe dans la sélection ou si group contient des indicateurs non définis.

Remarques

La valeur de group est interprétée comme suit. Le nombre de lampes d’une sélection constitue la limite supérieure exclusive du paramètre groupOrderIndex de IGameInputDevice::SetLightingColor lorsque vous ciblez une lampe individuelle par son ordinal. L’exception est GameInputLightingGroupKeyboardKey, qui cible les lampes individuelles par code de balayage du clavier. L’exemple suivant allume chaque lampe du groupe des boutons de façade avec une nuance de vert différente.
Les nombres de lampes ne changent pas pendant toute la durée de vie de l’objet périphérique.
La prise en charge de l’éclairage dépend du périphérique et de la plateforme. Actuellement, GameInput prend en charge l’éclairage des périphériques Windows Dynamic Lighting (LampArray) et de la barre lumineuse des manettes DualSense.

Configuration requise

En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de GameInput
IGameInputDevice
GameInputLightingGroups
IGameInputDevice::GetSupportedLightingGroups
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingColors

Historique des versions

Dernière modification le 6 novembre 2026