> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence de l'API d'éclairage pour les périphériques LampArray

> Référence de l'API d'éclairage du GDK pour énumérer les périphériques LampArray comme les claviers, les souris et les casques, et contrôler leur éclairage RVB.

# Référence de l'API d'éclairage

Documentation de référence de l'API d'éclairage pour le Microsoft Game Development Kit (GDK). Utilisez ces API pour énumérer les périphériques LampArray compatibles (claviers, souris, casques et autres appareils d'éclairage HID) et contrôler leur éclairage RVB.

## Énumérer les périphériques compatibles

Pour découvrir les périphériques compatibles, inscrivez un rappel d'état que l'API LampArray appelle pour chaque appareil connecté, puis de nouveau chaque fois qu'un appareil est branché ou retiré.

1. Implémentez une fonction [LampArrayStatusCallback](/fr-CA/reference/lighting/lamparray/functions/lamparraystatuscallback) pour recevoir les événements de connexion et de déconnexion des appareils.
2. Appelez [RegisterLampArrayStatusCallback](/fr-CA/reference/lighting/lamparray/functions/registerlamparraystatuscallback) pour inscrire le rappel. Passez une valeur [LampArrayEnumerationKind](/fr-CA/reference/lighting/lamparray/enums/lamparrayenumerationkind) pour déterminer si l'énumération initiale s'exécute de façon asynchrone ou si elle bloque jusqu'à ce que chaque appareil connecté ait été signalé.
3. Dans le rappel, examinez l'instance [ILampArray](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/ilamparray) pour lire les propriétés de l'appareil, comme [DeviceId](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid), [LampArrayKind](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind), [LampCount](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount), [VendorId](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getvendorid) et [ProductId](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getproductid).
4. Lorsque vous n'avez plus besoin des notifications, appelez [UnregisterLampArrayCallback](/fr-CA/reference/lighting/lamparray/functions/unregisterlamparraycallback) pour cesser de recevoir des événements.

Pour une procédure complète avec un exemple de code, consultez [Notions de base de LampArray](/fr-CA/build/core-features/common/lighting/lighting-basics).

## Dans cette section

[LampArray](/fr-CA/reference/lighting/lamparray/lamparray_members)<br />Membres de l'API LampArray, y compris les fonctions, les interfaces, les énumérations et les structures utilisées pour énumérer les appareils et contrôler l'éclairage.

## Voir aussi

[Vue d'ensemble de l'API d'éclairage](/fr-CA/build/core-features/common/lighting/gc-lighting-toc)


## Related topics

- [Référence des membres de l'API LampArray](/fr-CA/reference/lighting/lamparray/lamparray_members.md)
- [API d'éclairage et LampArray sur XBOX et PC](/fr-CA/build/core-features/common/lighting/index.md)
- [Vue d'ensemble de l'API d'éclairage](/fr-CA/build/core-features/common/lighting/gc-lighting-toc.md)
- [Notions de base de LampArray](/fr-CA/build/core-features/common/lighting/lighting-basics.md)
- [Méthode ILampArray::GetIsEnabled](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getisenabled.md)