> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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é.

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

### Paramètres

*address*<br />Type : PCWSTR

\[in] Adresse de la console.

*osIdentifier*<br />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

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite ; sinon, retourne un code d'erreur HRESULT.

<a id="remarksSection" />

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

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xtfapi.h

**Bibliothèque :** XtfApi.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="seealsoSection" />

## Voir aussi

[Déploiement Exécuter à partir du PC (rubrique NDA)](/fr/home/setup-install/concepts/deployment)<br />[Erreurs de transport XTF (rubrique NDA)](/fr/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[API Xtf supplémentaires](/fr/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfStartTitleOS](/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByVersion](/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)