Skip to main content

​
XtfStartTitleOS

Démarre ou redémarre le Game OS spécifié.

​
Syntaxe

​
Paramètres

address
Type : PCWSTR [in] Adresse de la console. osIdentifier
Type : PCWSTR [in, optional] Identificateur du Game OS à démarrer. Cet identificateur peut être l’un des éléments suivants :
  • Le chemin complet et le nom d’un fichier MicrosoftGame.config qui contient le numéro de version en quatre parties de la version du Game OS à démarrer
  • Le chemin complet et le nom d’un fichier GameOs.xvd
  • Le chemin complet d’un répertoire qui contient un fichier MicrosoftGame.config ou GameOS.vxd
  • Le numéro de version en quatre parties du Game OS à démarrer
Exemples d’identificateurs valides :
  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

​
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 le Game OS spécifié à partir du cache de la console. Si vous disposez d’une FourPartVersion pour le Game OS à démarrer, utilisez plutôt la fonction XtfStartTitleOSByVersion pour démarrer cette version du Game OS. Vous pouvez utiliser la fonction XtfGetCachedTitleOSVersions pour obtenir la FourPartVersion de chaque Game OS mis en cache sur la console, ou la fonction XtfGetTitleOSFourPartVersion pour obtenir la FourPartVersion du Game OS du titre en cours d’exécution. Vous pouvez également utiliser la fonction XtfStartTitleOSByGameConfig pour démarrer le Game OS identifié dans le contenu spécifié d’un fichier MicrosoftGame.config. Si nécessaire, 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 provisionnés, consultez Gestion des applications (xbapp.exe) (rubrique NDA) et Provisionnement (xbprovision.exe) (rubrique 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 Exécuter à partir du PC (rubrique NDA)
Erreurs de transport XTF (rubrique NDA)
API Xtf supplémentaires
Last modified on October 6, 2026