Skip to main content

XGameRuntimeInitialize

Inicializa Gaming Runtime.

Sintaxis

Parámetros

Ninguno.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte Códigos de error. Si la función falla porque no se encontró la biblioteca de Gaming Runtime (xgameruntime.dll), el valor devuelto se establece en E_GAMERUNTIME_DLL_NOT_FOUND.

Comentarios

Para usar las características de Gaming Runtime en su juego, primero inicialice Gaming Runtime invocando la función XGameRuntimeInitialize. Invoque la función XGameRuntimeInitialize lo antes posible, normalmente dentro de la función de punto de entrada del juego. De forma similar, anule la inicialización de Gaming Runtime lo más tarde posible, pero antes de que el juego se cierre, invocando la función XGameRuntimeUninitialize. Cada binario que se compila y vincula con el entorno de ejecución del juego debe llamar a XGameRuntimeInitialize al principio del inicio. Esto incluye el binario del juego y cualquier middleware en forma de dll que use características de Gaming Runtime. Internamente, la función XGameRuntimeInitialize comprueba las versiones de todas las interfaces con las que se compiló el título y las usa para inicializar los servicios del entorno de ejecución correspondientes. Entre dos versiones diferentes de Gaming Runtime, se pueden agregar o quitar funciones o, en raras ocasiones, puede haber cambios de comportamiento importantes. Llamar a XGameRuntimeInitialize desde cada componente ayudará a detectar problemas de configuración de compilación, como compilar con dos versiones diferentes e incompatibles del entorno de ejecución del juego en dos binarios distintos que se cargarán en el mismo proceso. Estas configuraciones incompatibles producen un error E_GAMERUNTIME_VERSION_MISMATCH. En el ejemplo siguiente se muestra cómo usar las funciones XGameRuntimeInitialize y XGameRuntimeUninitialize dentro de la función de punto de entrada de un juego basado en la plantilla Direct3D 12 Desktop Game de Visual Studio. La función XGameRuntimeInitialize se invoca antes de crear una instancia del objeto Game y registrarlo, y la función XGameRuntimeUninitialize se invoca después de restablecer el objeto Game, pero antes de que la función de punto de entrada devuelva el control.

Requisitos

Encabezado: XGameRuntimeInit.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XGameRuntimeUninitialize
XGameRuntimeInitializeWithOptions
XGameRuntimeInit
Estructuras de XGameRuntime
Enumeraciones de XGameRuntime
Desarrollo de nuevos títulos con Gaming Runtime
Última modificación el 28 de agosto de 2026