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.libPlateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series
Voir aussi
XGameStreamingXGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
