Skip to main content

XUserRegisterForChangeEvent

Inscrit un rappel pour un événement de modification d’utilisateur.

Syntaxe

Paramètres

queue   _In_opt_
Type : XTaskQueueHandle
Handle vers la file d’attente asynchrone sur laquelle effectuer l’opération. context   _In_opt_
Type : void*
Contexte défini par l’utilisateur à transmettre au rappel. callback   _In_
Type : XUserChangeEventCallback*
Rappel défini par l’utilisateur à inscrire. token   _Out_
Type : XTaskQueueRegistrationToken*
Contient un jeton identifiant le rappel inscrit. Utilisez ce jeton pour désinscrire le rappel.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.
Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
L’énumération XUserChangeEvent spécifie un type d’événement de modification. XUserChangeEventCallback est un rappel pour un événement de modification d’utilisateur. Pour désinscrire un rappel de modification d’utilisateur précédemment inscrit, appelez XUserUnregisterForChangeEvent. L’exemple suivant montre comment gérer les événements de modification d’utilisateur.

Configuration requise

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

Documentation conceptuelle

Voir aussi

XUser XUserChangeEvent XUserChangeEventCallback XUserUnregisterForChangeEvent
Last modified on October 6, 2026