Skip to main content

​
XSystemHandleTrack

Inscrit un rappel pour suivre les événements de durée de vie des handles dans le Gaming Runtime.

​
Syntaxe

​
Paramètres

callback    _In_
Type : XSystemHandleCallback Rappel défini par l’utilisateur qui sera appelé lors de la création et de la destruction des handles. Pour désactiver le suivi des handles, transmettez NULL pour le rappel. context    _In_opt_
Type : void * Contexte défini par l’utilisateur à transmettre au rappel.

​
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.

​
Remarques

Les développeurs de jeux doivent être en mesure de résoudre les bogues liés à une utilisation incorrecte des handles. La plupart des API GRTS utilisent des handles qui correspondent à la durée de vie d’objets internes dans notre implémentation de la plateforme. Les jeux rencontrent souvent des problèmes causés par des développeurs qui fournissent accidentellement des handles non valides (NULL, déjà libérés, etc.) à ces API, ce qui entraîne des plantages du titre. Les développeurs peuvent aussi involontairement laisser fuir des handles, ce qui entraîne une utilisation excessive des ressources. L’objectif de l’API de suivi des handles est de permettre aux développeurs de diagnostiquer et de corriger ces problèmes. L’API comporte deux composants : actif et passif. Tous les handles créés par GRTS sont suivis en continu, dans les scénarios de débogage comme de vente au détail. Chaque fois que des handles sont transmis à nos API, la plateforme effectue une validation pour s’assurer que ces handles correspondent à des objets internes valides. Si un handle non valide est détecté, la plateforme consigne l’erreur et appelle XErrorReport pour informer le développeur du problème. La plateforme ne fait aucun effort supplémentaire pour supprimer l’utilisation du handle non valide et laisse l’application planter comme elle l’aurait fait avant cette fonctionnalité. Enfin, toute fuite de handle au moment de XGameRuntimeUninitialize est également signalée au moyen de XErrorReport. Pour le moment, le système de suivi des handles ne permet pas de suivre les handles externes à GRTS.

​
Configuration requise

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

​
Voir aussi

Membres de XSystem XSystemHandleCallback
Last modified on October 6, 2026