Skip to main content

XGameRuntimeInitialize

Initialise le Gaming Runtime.

Syntaxe

Paramètres

Aucun.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur. Si la fonction échoue parce que la bibliothèque du Gaming Runtime (xgameruntime.dll) est introuvable, la valeur de retour est définie sur E_GAMERUNTIME_DLL_NOT_FOUND.

Remarques

Pour utiliser les fonctionnalités du Gaming Runtime dans votre jeu, initialisez d’abord le Gaming Runtime en appelant la fonction XGameRuntimeInitialize. Appelez la fonction XGameRuntimeInitialize le plus tôt possible, généralement dans la fonction de point d’entrée de votre jeu. De même, désinitialisez le Gaming Runtime le plus tard possible, mais avant la fermeture de votre jeu, en appelant la fonction XGameRuntimeUninitialize. Chaque binaire compilé et lié au Gaming Runtime doit appeler XGameRuntimeInitialize tôt au démarrage. Cela inclut le binaire du jeu et tout middleware sous forme de DLL qui utilise des fonctionnalités du Gaming Runtime. En interne, la fonction XGameRuntimeInitialize vérifie les versions de toutes les interfaces avec lesquelles le titre a été compilé et les utilise pour initialiser les services runtime correspondants. D’une version à l’autre du Gaming Runtime, des fonctions peuvent être ajoutées ou supprimées, ou, dans de rares cas, présenter des changements de comportement cassants. Appeler XGameRuntimeInitialize depuis chaque composant permet de détecter des problèmes de configuration de build, par exemple la compilation par deux binaires différents, chargés dans le même processus, avec deux versions différentes et incompatibles du Gaming Runtime. De telles configurations incompatibles entraînent une erreur E_GAMERUNTIME_VERSION_MISMATCH. L’exemple suivant montre comment utiliser les fonctions XGameRuntimeInitialize et XGameRuntimeUninitialize dans la fonction de point d’entrée d’un jeu basé sur le modèle Direct3D 12 Desktop Game de Visual Studio. La fonction XGameRuntimeInitialize est appelée avant que l’objet Game soit instancié et inscrit, et la fonction XGameRuntimeUninitialize est appelée après la réinitialisation de l’objet Game, mais avant le retour de la fonction de point d’entrée.

Configuration requise

En-tête : XGameRuntimeInit.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XGameRuntimeUninitialize
XGameRuntimeInitializeWithOptions
XGameRuntimeInit
Structures XGameRuntime
Énumérations XGameRuntime
Développement de nouveaux titres avec le Gaming Runtime
Last modified on October 6, 2026