Skip to main content

RegisterLampArrayCallback

Inscrit une fonction de rappel à appeler chaque fois qu’un LampArray est connecté au système ou déconnecté de celui-ci.

Syntaxe

Paramètres

lampArrayCallback   _In_ Type : LampArrayCallback Fonction définie par l’appelant à inscrire. Elle est appelée lorsque des LampArrays sont connectés au système ou déconnectés de celui-ci. context   _In_opt_
Type : void*
Pointeur vers un objet contenant des informations pertinentes pour la fonction de rappel. Il s’agit généralement de l’objet appelant. callbackToken   _Out_ _Result_zeroonfailure_ Type : LampArrayCallbackToken* Valeur de jeton pouvant être utilisée pour désinscrire la fonction de rappel ultérieurement.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Si des périphériques LampArray sont connectés au moment de l’inscription d’un rappel, la fonction RegisterLampArrayCallback bloque jusqu’à ce que ce rappel soit appelé pour chaque périphérique connecté (ce qui signifie que le rappel est appelé sur le thread appelant). Lorsque le premier rappel est inscrit, l’API LampArray démarre un thread de travail pour gérer les notifications de connexion et de retrait des périphériques ILampArray. Ces événements sont peu fréquents, et le thread de travail reste sinon en état d’attente. Une fois l’appel d’inscription retourné, tous les LampArrayCallbacks suivants sont appelés séquentiellement sur ce thread de travail. Le code suivant est un exemple d’inscription et de désinscription d’un rappel LampArray :

Configuration requise

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

Voir aussi

Vue d’ensemble de l’API d’éclairage
Notions de base de l’éclairage
LampArrayCallback
UnregisterLampArrayCallback
Last modified on October 6, 2026