> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XSystemHandleTrack

> XSystemHandleTrack

# XSystemHandleTrack

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

## Syntaxe

```cpp theme={null}
HRESULT XSystemHandleTrack(
  XSystemHandleCallback callback,
  void * context
)
```

### Paramètres

*callback*    \_In\_\
Type : [XSystemHandleCallback](/fr-CA/reference/system/xsystem/functions/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](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

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](/fr-CA/reference/errorcodes).

## 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](/fr-CA/reference/system/xerror/functions/xerrorsetoptions) 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](/fr-CA/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize) est également signalée au moyen de
[XErrorReport](/fr-CA/reference/system/xerror/functions/xerrorsetoptions). 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](/fr-CA/reference/system/xsystem/xsystem_members)

[XSystemHandleCallback](/fr-CA/reference/system/xsystem/functions/xsystemhandlecallback)


## Related topics

- [XSystemHandleTrack](/reference/system/xsystem/functions/xsystemhandletrack.md)
- [XSystemHandleCallback](/reference/system/xsystem/functions/xsystemhandlecallback.md)