Pular para o conteúdo principal

​
XtfStartTitleOS

Inicia ou reinicia o Game OS especificado.

​
Sintaxe

​
Parâmetros

address
Tipo: PCWSTR [in] O endereço do console. osIdentifier
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

​
Valor retornado

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

​
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 para o Game OS que deseja iniciar, use a função XtfStartTitleOSByVersion para iniciar essa versão do Game OS. Você pode usar a função XtfGetCachedTitleOSVersions para obter a FourPartVersion de cada Game OS armazenado em cache no console ou a função XtfGetTitleOSFourPartVersion para obter a FourPartVersion do Game OS do título em execução no momento. Você também pode usar a função XtfStartTitleOSByGameConfig 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. Para obter mais informações sobre como gerenciar arquivos provisionados do Game OS, confira Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA) e Provisionamentoamento (xbprovision.exe) (tópico sob NDA).

​
Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

​
Confira também

Implantação de execução a partir do PC (tópico sob NDA)
Erros de transporte do XTF (tópico sob NDA)
APIs adicionais do Xtf
Última modificação em 6 de outubro de 2026