RegisterLampArrayStatusCallback
Inscrit une fonction de rappel à appeler chaque fois que l’état du LampArray change.Syntaxe
Paramètres
callbackFunc _In_ Type : LampArrayStatusCallback Fonction définie par l’appelant à inscrire. Elle est appelée lorsque l’état du LampArray change. enumerationKindType : LampArrayEnumerationKind Spécifie le comportement d’énumération des périphériques souhaité pour la fonction LampArrayStatusCallback. 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
Le paramètre LampArrayEnumerationKind permet à l’appelant de spécifier la manière dont il doit recevoir les rappels pour les périphériques LampArray connectés au moment de cet appel. Si LampArrayEnumerationKind::Blocking est sélectionné, la fonction RegisterLampArrayStatusCallback 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 d’état 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 LampArrayStatusCallbacks suivants sont appelés séquentiellement sur ce thread de travail. Si LampArrayEnumerationKind::Async est spécifié, cet appel retourne immédiatement, et les LampArrays connectés au moment de l’appel sont énumérés sur le thread de travail des rappels LampArray mentionné ci-dessus. Le code suivant est un exemple d’inscription et de désinscription d’une fonction LampArrayStatusCallback :Configuration requise
En-tête : LampArray.h Bibliothèque : xgameplatform.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
Vue d’ensemble de l’API d’éclairageNotions de base de l’éclairage
LampArrayStatusCallback
UnregisterLampArrayCallback
LampArrayEnumerationKind
