Passer au contenu principal
Envoie au périphérique d’entrée toutes les couleurs d’éclairage préparées en une seule mise à jour.

Syntaxe

Paramètres

Cette méthode n’a aucun paramètre.

Valeur de retour

Type : void

Remarques

Les couleurs que vous définissez en appelant IGameInputDevice::SetLightingColor sont uniquement préparées ; elles ne modifient pas les lampes tant que vous n’appelez pas ApplyLightingColors. Cette méthode envoie au périphérique les couleurs préparées de toutes les lampes en une seule écriture, de sorte que les modifications apportées à plusieurs groupes ou lampes prennent effet en même temps. Seules les lampes pour lesquelles une couleur a été préparée sont mises à jour. Si aucune couleur n’est préparée, l’appel n’a aucun effet. Les couleurs préparées restent en vigueur après leur application. Pour modifier ultérieurement un groupe, préparez la nouvelle couleur pour ce groupe et appelez de nouveau ApplyLightingColors ; les couleurs des autres lampes sont conservées. Pour ignorer toutes les couleurs préparées et rétablir le comportement par défaut des lampes, appelez IGameInputDevice::ApplyLightingSystemDefault. Lorsque le périphérique se déconnecte, ses couleurs préparées sont ignorées. Les appels sur un périphérique déconnecté n’ont aucun effet. L’exemple suivant définit en rouge les boutons de façade d’une manette et en bleu son voyant central, puis applique les deux couleurs en une seule mise à jour.
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
IGameInputDevice::SetLightingColor
IGameInputDevice::ApplyLightingSystemDefault
IGameInputDevice::GetSupportedLightingGroups
GameInputColor
GameInputLightingGroups

Historique des versions

Dernière modification le 6 novembre 2026