Skip to main content

XGameStreamingShowTouchControlsWithStateUpdate

Demande à tous les appareils clients de streaming connectés de mettre à jour l’état de leurs commandes tactiles et d’afficher une disposition tactile spécifiée. Toutes les mises à jour d’état ont lieu avant l’affichage de la nouvelle disposition tactile.

Syntaxe

Paramètres

layout   _In_opt_z_
Type : char*
Nom de la disposition des commandes tactiles à afficher, ou nullptr pour afficher la disposition standard. operationCount   _In_
Type : size_t
Taille du tableau d’opérations transmis operations   _In_reads_opt_(operationCount)
Type : XGameStreamingTouchControlsStateOperation*
Tableau de toutes les mises à jour de variables d’état demandées

Valeur de retour

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

Erreurs potentielles

Remarques

Cette API doit être utilisée lorsque le jeu doit afficher une disposition tactile particulière qui nécessite également des mises à jour d’état susceptibles d’affecter son rendu. Utilisez cette API si vous souhaitez à la fois mettre à jour l’état des variables référencées dans une nouvelle disposition tactile ET basculer vers cette disposition tactile sur tous les appareils clients de streaming connectés. Cette API garantit que toutes les mises à jour d’état sont effectuées avant l’affichage de la nouvelle disposition. Si vous souhaitez n’affecter qu’un client spécifique, utilisez XGameStreamingShowTouchControlsWithStateUpdateOnClient. Si le jeu souhaite uniquement changer de disposition, il doit plutôt utiliser XGameStreamingShowTouchControlLayout. Si les mises à jour d’état peuvent affecter la disposition actuelle ou d’autres dispositions et doivent avoir lieu indépendamment d’un changement de disposition tactile spécifique, le jeu doit plutôt utiliser XGameStreamingUpdateTouchControlsState.

Exemples

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

Voir aussi

XGameStreaming
XGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
Last modified on October 6, 2026