Skip to main content

XGameStreamingShowTouchControlsWithStateUpdate

Demande à tous les appareils clients de diffusion en continu 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 pouvant influer sur 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 passer à cette disposition tactile sur tous les appareils clients de diffusion en continu 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 agir uniquement sur un client précis, utilisez XGameStreamingShowTouchControlsWithStateUpdateOnClient. Si le jeu souhaite uniquement changer la disposition, il doit plutôt utiliser XGameStreamingShowTouchControlLayout. Si les mises à jour d’état peuvent influer sur la disposition actuelle ou sur d’autres dispositions, et que les mises à jour doivent avoir lieu indépendamment d’un changement de disposition tactile précis, 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