> ## 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.

# XtfStartTitleOSByVersion

> XtfStartTitleOSByVersion

# XtfStartTitleOSByVersion

Démarre ou redémarre le Game OS correspondant à la [FourPartVersion](/fr/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s) spécifiée à partir du cache de la console.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XtfStartTitleOSByVersion(
         PCWSTR address,
         FourPartVersion version
)  
```

<a id="parametersSection" />

### Paramètres

*address*<br />Type : PCWSTR

\[in] L'adresse de la console.

*version*<br />Type : [FourPartVersion](/fr/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s)

\[in] Les informations de version en quatre parties du Game OS à démarrer.

<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 correspondant à la `FourPartVersion` spécifiée à partir du cache de la console.  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.

Si vous ne disposez pas d'une [FourPartVersion](/fr/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s) pour le Game OS que vous souhaitez démarrer ou redémarrer, utilisez plutôt la fonction [XtfStartTitleOS](/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m) 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 également utiliser la fonction [XtfStartTitleOSByGameConfig](/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m) pour démarrer ou redé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 sous NDA)](/fr/tools/tools-console/commandlinetools/xbapp) et [Provisionnement (xbprovision.exe) (rubrique sous 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 par exécution à partir du PC (rubrique sous NDA)](/fr/home/setup-install/concepts/deployment)<br />[Erreurs de transport XTF (rubrique sous NDA)](/fr/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[API Xtf supplémentaires](/fr/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfStartTitleOS](/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](/fr/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [FourPartVersion](/fr/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)
- [XtfStartTitleOSByGameConfig](/fr/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersions](/fr/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)