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