Pular para o conteúdo principal

XtfStartTitleOSByVersion

Inicia ou reinicia o Game OS correspondente à FourPartVersion especificada a partir do cache no console.

Sintaxe

Parâmetros

address
Tipo: PCWSTR
[in] O endereço do console. version
Tipo: FourPartVersion
[in] As informações de versão de quatro partes do Game OS a ser iniciado.

Valor de retorno

Tipo: HRESULT Retorna S_OK se tiver êxito; caso contrário, retorna um código de erro HRESULT.

Comentários

Use esta função para iniciar ou reiniciar o Game OS correspondente à FourPartVersion especificada a partir do cache no console. 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. Se você não tiver uma FourPartVersion para o Game OS que deseja iniciar ou reiniciar, use a função XtfStartTitleOS para iniciar ou reiniciar um Game OS especificando um identificador diferente, como o caminho completo e o nome do arquivo GameOs.vxd de um Game OS. Você também pode usar a função XtfStartTitleOSByGameConfig para iniciar ou reiniciar 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 de Game OS provisionados, confira Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA) e Provisionamento (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