Skip to main content

​
XGameActivationRegisterForEvent

Inscrit un rappel pour les événements d’activation.

​
Syntaxe

​
Paramètres

queue   _In_opt_
Type : XTaskQueueHandle File d’attente de tâches qui distribue le rappel d’événement. context   _In_opt_
Type : void* Contexte passé au rappel d’événement. callback   _In_
Type : XGameActivationCallback* Fonction de rappel d’événement. token   _Out_
Type : XTaskQueueRegistrationToken* Jeton de la file d’attente de tâches qui représente l’inscription. Utilisez ce jeton pour désinscrire le rappel pour les événements d’activation.

​
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

Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
La fonction XGameActivationRegisterForEvent prend comme argument un XGameActivationCallback. Le rappel reçoit une structure XGameActivationInfo qui contient le type d’activation et les données correspondantes. Cette API gère tous les types d’activation, notamment l’activation de protocole, l’activation de fichier et les invitations de jeu. Elle remplace les API dépréciées XGameProtocolRegisterForActivation et XGameInviteRegisterForEvent. Pour désinscrire un rappel pour les événements d’activation, appelez XGameActivationUnregisterForEvent. Pour obtenir un exemple d’appel de cette fonction, consultez la section Remarques de la rubrique XGameActivationCallback.

​
Configuration requise

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

​
Documentation conceptuelle

​
Voir aussi

XGameActivation XGameActivationCallback XGameActivationUnregisterForEvent
Last modified on October 6, 2026