Skip to main content

XGameStreamingRegisterConnectionStateChanged

Inscrit un rappel à appeler lorsque l’état de connexion d’un appareil client de streaming change. Lors de l’inscription, le rappel est appelé pour tous les appareils clients de streaming déjà connectés.

Syntaxe

Paramètres

queue   _In_opt_
Type : XTaskQueueHandle
Handle de la file d’attente asynchrone dans laquelle placer le rappel de modification. context   _In_opt_
Type : void*
Pointeur facultatif vers le contexte passé à la fonction de rappel. callback   _In_
Type : XGameStreamingConnectionStateChangedCallback*
Fonction de rappel qui sera appelée lorsque l’état de connexion d’un appareil client de streaming change. token   _Out_
Type : XTaskQueueRegistrationToken*
Pointeur vers le jeton d’inscription qui peut être utilisé pour annuler l’inscription à l’événement.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur.

Erreurs potentielles

Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread à contrainte de temps. Pour plus d’informations, consultez Threads à contrainte de temps.
Cette API est la méthode recommandée pour permettre au jeu d’effectuer des personnalisations par appareil client de streaming et de maintenir un état qui lui permet d’optimiser l’expérience selon que des appareils sont connectés ou non.
Lors de l’inscription, le rappel est appelé pour tous les appareils clients de streaming actuellement connectés.

Exemple

Configuration requise

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

Documentation conceptuelle

Voir aussi

XGameStreamingConnectionState
XGameStreamingConnectionStateChangedCallback
XGameStreamingUnregisterConnectionStateChanged
XGameStreaming
Last modified on October 6, 2026