> ## 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 système d'exploitation de jeu 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 système d'exploitation de jeu à démarrer. Cet identificateur peut être l'un des éléments suivants :

* Le chemin complet et le nom de fichier d'un fichier MicrosoftGame.config qui contient le numéro de version en quatre parties de la version du système d'exploitation de jeu à démarrer
* Le chemin complet et le nom de fichier 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 système d'exploitation de jeu à 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 système d'exploitation de jeu spécifié à partir du cache de la console.

Si vous disposez d'une [FourPartVersion](/fr-CA/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s) pour le système d'exploitation de jeu à démarrer, utilisez plutôt la fonction [XtfStartTitleOSByVersion](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m) pour démarrer cette version du système d'exploitation de jeu. Vous pouvez utiliser la fonction [XtfGetCachedTitleOSVersions](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m) pour obtenir la `FourPartVersion` de chaque système d'exploitation de jeu mis en cache sur la console, ou la fonction [XtfGetTitleOSFourPartVersion](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m) pour obtenir la `FourPartVersion` du système d'exploitation de jeu du titre en cours d'exécution. Vous pouvez également utiliser la fonction [XtfStartTitleOSByGameConfig](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m) pour démarrer le système d'exploitation de jeu identifié dans le contenu spécifié d'un fichier MicrosoftGame.config.

Au besoin, vous pouvez ajouter un système d'exploitation de jeu au cache de la console en appelant la fonction [XtfCacheTitleOS](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m). Pour plus d'informations sur la gestion des fichiers provisionnés du système d'exploitation de jeu, consultez [Gestion des applications (xbapp.exe) (rubrique NDA)](/fr-CA/tools/tools-console/commandlinetools/xbapp) et [Provisionnement (xbprovision.exe) (rubrique NDA)](/fr-CA/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 par exécution à partir du PC (rubrique NDA)](/fr-CA/home/setup-install/concepts/deployment)<br />[Erreurs de transport XTF (rubrique NDA)](/fr-CA/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[API Xtf supplémentaires](/fr-CA/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfStartTitleOSByVersion](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByGameConfig](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](/fr-CA/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [Méthode IXtfDebugMonitorClient::Start](/fr-CA/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorClient/methods/start-ixtfdebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m.md)
- [FourPartVersion](/fr-CA/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)