Skip to main content

XGameStreamingGetTouchBundleVersion

Obtient la version du bundle d’adaptation tactile actuellement utilisé sur l’appareil spécifié.

Syntaxe

Paramètres

client   _In_
Type : XGameStreamingClientId
Client de streaming interrogé. version   _Out_opt_
Type : XVersion*
Numéro de version du bundle actuellement utilisé sur le client spécifié. Si aucun numéro de version n’est spécifié dans le bundle, 0.0.0.0 est retourné. versionNameSize   _In_
Type : size_t
Taille maximale en octets du versionName à retourner. La taille à spécifier peut être obtenue en appelant XGameStreamingGetTouchBundleVersionNameSize. versionName   _Out_writes_opt_z_
Type : char*
Nom de version du bundle actuellement utilisé sur le client spécifié. Si aucun nom de version n’est spécifié dans le bundle, null est retourné.

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

Les dispositions tactiles présentées au joueur pendant le streaming de jeux utilisent des dispositions prédéfinies chargées sur les serveurs de Microsoft dans le cadre d’un bundle d’adaptation tactile. XGameStreamingGetTouchBundleVersion permet au jeu de prendre des décisions au moment de l’exécution en fonction de l’ensemble de contrôles tactiles utilisés sur un client particulier. Voici quelques exemples d’utilisation :
  • Retirer un élément du HUD si le joueur utilise l’écran tactile et que l’élément est disponible via les contrôles tactiles superposés.
  • Choisir les indications graphiques à afficher dans le jeu en fonction des dispositions tactiles qui seront affichées.
La valeur version est unique pour chaque version chargée sur le service. Chaque mise à jour nécessite un nouveau numéro de version. Le versionName peut servir à fournir une version sémantique (par exemple, il s’agit d’un ensemble de dispositions qui prennent en charge le DLC2) plutôt que de dépendre d’un numéro de version spécifique. Par exemple, si les numéros de version sont attribués automatiquement par votre système de génération, il peut être difficile pour le code du jeu de connaître le numéro de version exact des bundles d’adaptation tactile qui apparaîtront au moment de l’exécution. Pour permettre au code de détecter la présence d’un bundle sans devoir connaître sa version exacte, vous pouvez choisir d’utiliser un nom de version au lieu d’effectuer des comparaisons basées sur un numéro de version.

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

Voir aussi

XGameStreaming
XGameStreamingGetTouchBundleVersionNameSize
Last modified on October 6, 2026