Skip to main content

XGameStreamingRegisterConnectionStateChanged

Inscrit un rappel à appeler lorsque l’état de connexion d’un appareil client de diffusion en continu change. Lors de l’inscription, le rappel est appelé pour tous les appareils clients de diffusion en continu 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 transmis à 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 diffusion en continu 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

Cette fonction ne peut pas être appelée de façon sécuritaire sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Cette API est la méthode recommandée pour permettre au jeu d’effectuer des personnalisations par appareil client de diffusion en continu et de maintenir un état qui lui permet d’optimiser l’expérience selon qu’un appareil est connecté ou non.
Lors de l’inscription, le rappel est appelé pour tous les appareils clients de diffusion en continu 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