> ## 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 ou reinicia o Game OS especificado.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*address*<br />Tipo: PCWSTR

\[in] O endereço do console.

*osIdentifier*<br />Tipo: PCWSTR

\[in, optional] O identificador do Game OS a ser iniciado. Esse identificador pode ser um dos seguintes:

* O caminho completo e o nome de um arquivo MicrosoftGame.config que contém o número de versão de quatro partes da versão do Game OS a ser iniciada
* O caminho completo e o nome de um arquivo GameOs.xvd
* O caminho completo para um diretório que contém um arquivo MicrosoftGame.config ou GameOS.vxd
* O número de versão de quatro partes do Game OS a ser iniciado

Exemplos de identificadores válidos:

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

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

<a id="remarksSection" />

## Comentários

Use essa função para iniciar ou reiniciar o Game OS especificado a partir do cache no console.

Se você tiver uma [FourPartVersion](/pt-BR/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s) para o Game OS que deseja iniciar, use a função [XtfStartTitleOSByVersion](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m) para iniciar essa versão do Game OS. Você pode usar a função [XtfGetCachedTitleOSVersions](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m) para obter a `FourPartVersion` de cada Game OS armazenado em cache no console ou a função [XtfGetTitleOSFourPartVersion](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m) para obter a `FourPartVersion` do Game OS do título em execução no momento. Você também pode usar a função [XtfStartTitleOSByGameConfig](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m) para iniciar o Game OS identificado no conteúdo especificado de um arquivo MicrosoftGame.config.

Se necessário, você pode adicionar um Game OS ao cache no console chamando a função [XtfCacheTitleOS](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m). Para obter mais informações sobre como gerenciar arquivos provisionados do Game OS, confira [Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbapp) e [Provisionamentoamento (xbprovision.exe) (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbprovision).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

<a id="seealsoSection" />

## Confira também

[Implantação de execução a partir do PC (tópico sob NDA)](/pt-BR/home/setup-install/concepts/deployment)<br />[Erros de transporte do XTF (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[APIs adicionais do Xtf](/pt-BR/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

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