Skip to main content

XGameStreamingRegisterClientPropertiesChanged

Inscrit un rappel à appeler lorsque les propriétés d’un appareil client de streaming changent.
Lors de l’inscription, le rappel est appelé pour les propriétés actuelles de l’appareil client.

Syntaxe

Paramètres

client   _In_
Type : XGameStreamingClientId
ID du client de streaming de jeux pour lequel vous vous inscrivez afin de recevoir des rappels. 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 un contexte qui sera passé à la fonction de rappel. callback   _In_
Type : XGameStreamingClientPropertiesChangedCallback*
Fonction de rappel qui sera appelée lorsque les propriétés du client changent. 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 permet au jeu de recevoir un XGameStreamingClientPropertiesChangedCallback chaque fois qu’une XGameStreamingClientProperty, comme les dimensions physiques du flux, change. L’inscription ENTRAÎNE l’appel du rappel avec toutes les XGameStreamingClientProperty applicables, afin de pouvoir interroger les détails actuels des propriétés. Lorsque l’appareil client de streaming se déconnecte, utilisez XGameStreamingUnregisterClientPropertiesChanged pour annuler l’inscription du rappel.

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

XGameStreamingClientProperty
XGameStreamingClientPropertiesChangedCallback
XGameStreamingUnregisterClientPropertiesChanged
XGameStreaming
Last modified on October 6, 2026