Passer au contenu principal

XtfStartTitleOSByVersion

Démarre ou redémarre, à partir du cache de la console, le Game OS correspondant à la FourPartVersion spécifiée.

Syntaxe

Paramètres

address
Type : PCWSTR
[in] L’adresse de la console. version
Type : FourPartVersion
[in] Les informations de version en quatre parties du Game OS à démarrer.

Valeur de retour

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

Remarques

Utilisez cette fonction pour démarrer ou redémarrer, à partir du cache de la console, le Game OS correspondant à la FourPartVersion spécifiée. Vous pouvez utiliser la fonction XtfGetCachedTitleOSVersions pour obtenir la FourPartVersion de chaque Game OS en cache sur la console, ou la fonction XtfGetTitleOSFourPartVersion pour obtenir la FourPartVersion du Game OS du titre en cours d’exécution. Si vous ne disposez pas d’une FourPartVersion pour le Game OS que vous voulez démarrer ou redémarrer, utilisez plutôt la fonction XtfStartTitleOS pour démarrer ou redémarrer un Game OS en spécifiant un autre identificateur, comme le chemin d’accès complet et le nom du fichier GameOs.vxd d’un Game OS. Vous pouvez aussi utiliser la fonction XtfStartTitleOSByGameConfig pour démarrer ou redémarrer le Game OS identifié dans le contenu spécifié d’un fichier MicrosoftGame.config. Au besoin, vous pouvez ajouter un Game OS au cache de la console en appelant la fonction XtfCacheTitleOS. Pour plus d’informations sur la gestion des fichiers Game OS approvisionnés, consultez Gestion des applications (xbapp.exe) (rubrique sous NDA) et Approvisionnement (xbprovision.exe) (rubrique sous NDA).

Configuration requise

En-tête : xtfapi.h Bibliothèque : XtfApi.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

Voir aussi

Déploiement par exécution à partir du PC (rubrique sous NDA)
Erreurs de transport XTF (rubrique sous NDA)
API Xtf supplémentaires
Dernière modification le 6 octobre 2026