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

Inicia o reinicia el Game OS especificado.

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*address*<br />Tipo: PCWSTR

\[in] La dirección de la consola.

*osIdentifier*<br />Tipo: PCWSTR

\[in, optional] El identificador del Game OS que se va a iniciar. Este identificador puede ser uno de los siguientes:

* La ruta de acceso completa y el nombre de archivo de un archivo MicrosoftGame.config que contiene el número de versión de cuatro partes de la versión del Game OS que se va a iniciar
* La ruta de acceso completa y el nombre de archivo de un archivo GameOs.xvd
* La ruta de acceso completa a un directorio que contiene un archivo MicrosoftGame.config o GameOS.vxd
* El número de versión de cuatro partes del Game OS que se va a iniciar

Ejemplos de identificadores válidos:

* D:\MyGame
* \MyDevPC\share\MyGame\MicrosoftGame.config
* xd:\Titles\MyGamePFN\GameOs.xvd
* 10.0.18236.1002

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.

<a id="remarksSection" />

## Comentarios

Use esta función para iniciar o reiniciar el Game OS especificado desde la caché de la consola.

Si tiene un [FourPartVersion](/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s) para el Game OS que quiere iniciar, use en su lugar la función [XtfStartTitleOSByVersion](/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m) para iniciar esa versión del Game OS. Puede usar la función [XtfGetCachedTitleOSVersions](/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m) para obtener el `FourPartVersion` de cada Game OS almacenado en caché en la consola, o la función [XtfGetTitleOSFourPartVersion](/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m) para obtener el `FourPartVersion` del Game OS del título actualmente en ejecución. También puede usar la función [XtfStartTitleOSByGameConfig](/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m) para iniciar el Game OS identificado en el contenido especificado de un archivo MicrosoftGame.config.

Si es necesario, puede agregar un Game OS a la caché de la consola llamando a la función [XtfCacheTitleOS](/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m). Para obtener más información sobre la administración de archivos aprovisionados del Game OS, consulte [Administración de aplicaciones (xbapp.exe) (tema con NDA)](/tools/tools-console/commandlinetools/xbapp) y [Aprovisionamiento (xbprovision.exe) (tema con NDA)](/tools/tools-console/commandlinetools/xbprovision).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas compatibles:** Windows (para las herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

[Implementación de ejecución desde PC (tema con NDA)](/home/setup-install/concepts/deployment)<br />[Errores de transporte de XTF (tema con NDA)](/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[API de Xtf adicionales](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

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