XGameRuntimeInitialize
Inicializa o Gaming Runtime.Sintaxe
Parâmetros
Nenhum.Valor retornado
Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro. Se a função falhar porque a biblioteca do Gaming Runtime (xgameruntime.dll) não foi encontrada, o valor retornado será definido como E_GAMERUNTIME_DLL_NOT_FOUND.Comentários
Para usar os recursos do Gaming Runtime em seu jogo, primeiro inicialize o Gaming Runtime invocando a função XGameRuntimeInitialize. Invoque a função XGameRuntimeInitialize o mais cedo possível, normalmente dentro da função de ponto de entrada do seu jogo. Da mesma forma, cancele a inicialização do Gaming Runtime o mais tarde possível, mas antes de o jogo ser encerrado, invocando a função XGameRuntimeUninitialize. Cada binário compilado e vinculado ao runtime do jogo deve chamar XGameRuntimeInitialize no início da inicialização. Isso inclui o binário do jogo e qualquer middleware em forma de dll que use recursos do Gaming Runtime. Internamente à função XGameRuntimeInitialize, as versões de todas as interfaces com as quais o título foi compilado são verificadas e usadas para inicializar os serviços de runtime correspondentes. Entre duas versões diferentes do Gaming Runtime, funções podem ser adicionadas ou removidas ou, em casos raros, ter alterações de comportamento significativas. Chamar XGameRuntimeInitialize a partir de cada componente ajudará a detectar problemas de configuração de build, como a compilação com duas versões diferentes e incompatíveis do runtime do jogo por dois binários diferentes que serão carregados no mesmo processo. Essas configurações incompatíveis resultam em um erro E_GAMERUNTIME_VERSION_MISMATCH. O exemplo a seguir demonstra como usar as funções XGameRuntimeInitialize e XGameRuntimeUninitialize dentro da função de ponto de entrada de um jogo baseado no modelo Direct3D 12 Desktop Game no Visual Studio. A função XGameRuntimeInitialize é invocada antes de o objeto Game ser instanciado e registrado, e a função XGameRuntimeUninitialize é invocada depois que o objeto Game é redefinido, mas antes que a função de ponto de entrada retorne.Requisitos
Cabeçalho: XGameRuntimeInit.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
Confira também
XGameRuntimeUninitializeXGameRuntimeInitializeWithOptions
XGameRuntimeInit
Estruturas de XGameRuntime
Enumerações de XGameRuntime
Desenvolvendo novos títulos usando o Gaming Runtime
