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

Inicia o reinicia el Game OS especificado.

## Sintaxis

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

### Parámetros

*address*\
Tipo: PCWSTR

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

*osIdentifier*\
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

### Valor devuelto

Tipo: HRESULT

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

## Comentarios

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

Si tiene un [FourPartVersion](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) para el Game OS que quiere iniciar, use en su lugar la función [XtfStartTitleOSByVersion](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md) para iniciar esa versión del Game OS. Puede usar la función [XtfGetCachedTitleOSVersions](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md) para obtener el `FourPartVersion` de cada Game OS almacenado en caché en la consola, o la función [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md) para obtener el `FourPartVersion` del Game OS del título actualmente en ejecución. También puede usar la función [XtfStartTitleOSByGameConfig](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md) 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](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md). 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)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xbapp.md) y [Aprovisionamiento (xbprovision.exe) (tema con NDA)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xbprovision.md).

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

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

## Consulte también

[Implementación de ejecución desde PC (tema con NDA)](https://docs.xbox.com/es/home/setup-install/concepts/deployment.md)\
[Errores de transporte de XTF (tema con NDA)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[API de Xtf adicionales](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfStartTitleOSByVersion](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)
- [API de Xtf adicionales (contenido de la API)](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfStartTitleOSByGameConfig](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md)
- [Start](https://docs.xbox.com/es/reference/tools/xtf/xtfdebugmonitor/classes/IXtfDebugMonitorClient/methods/start-ixtfdebugmonitorclient-xtfdebugmonitor-xbox-microsoft-m.md)
- [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)