> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfStartTitleOS

> XtfStartTitleOS

# XtfStartTitleOS

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

## Syntaxe

```cpp theme={null}
HRESULT XtfStartTitleOS(
         PCWSTR address,
         PCWSTR osIdentifier
)  
```

### 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](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) pour le Game OS à démarrer, utilisez plutôt la fonction [XtfStartTitleOSByVersion](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md) pour démarrer cette version du Game OS. Vous pouvez utiliser la fonction [XtfGetCachedTitleOSVersions](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md) pour obtenir la `FourPartVersion` de chaque Game OS mis en cache sur la console, ou la fonction [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md) pour obtenir la `FourPartVersion` du Game OS du titre en cours d'exécution. Vous pouvez également utiliser la fonction [XtfStartTitleOSByGameConfig](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md) 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](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md). Pour plus d'informations sur la gestion des fichiers Game OS provisionnés, consultez [Gestion des applications (xbapp.exe) (rubrique NDA)](https://docs.xbox.com/fr/tools/tools-console/commandlinetools/xbapp.md) et [Provisionnement (xbprovision.exe) (rubrique NDA)](https://docs.xbox.com/fr/tools/tools-console/commandlinetools/xbprovision.md).

## 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)](https://docs.xbox.com/fr/home/setup-install/concepts/deployment.md)\
[Erreurs de transport XTF (rubrique NDA)](https://docs.xbox.com/fr/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[API Xtf supplémentaires](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfStartTitleOSByVersion](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)
- [API Xtf supplémentaires (contenu de l'API)](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfStartTitleOSByGameConfig](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md)
- [Start](https://docs.xbox.com/fr/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorClient/methods/start-ixtfdebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m.md)
- [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/fr/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)