> ## 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

Registra una devolución de llamada para realizar el seguimiento de los eventos de duración de los identificadores en el Gaming Runtime.

## Sintaxis

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

### Parámetros

*callback*    \_In\_\
Tipo: [XSystemHandleCallback](/reference/system/xsystem/functions/xsystemhandlecallback)

Una devolución de llamada definida por el usuario a la que se llamará al crear y destruir identificadores. Para deshabilitar el
seguimiento de identificadores, pase NULL como devolución de llamada.

*context*    \_In\_opt\_\
Tipo: void \*

Contexto definido por el usuario que se pasará a la devolución de llamada.

### Valor devuelto

Tipo:  [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

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

## Comentarios

Los desarrolladores de juegos necesitan tener la capacidad de solucionar errores relacionados con el uso incorrecto de identificadores.
La mayoría de las API de GRTS utilizan identificadores que corresponden a la duración de objetos internos en la
implementación de nuestra plataforma. Los juegos suelen encontrar problemas causados por desarrolladores que proporcionan accidentalmente
identificadores no válidos (NULL, liberados previamente, etc.) a estas API, lo que provoca bloqueos del título.
Los desarrolladores también pueden filtrar identificadores de forma inadvertida, lo que provoca un uso excesivo de recursos. El objetivo de
la API de seguimiento de identificadores es permitir a los desarrolladores diagnosticar y corregir estos problemas.

La API tiene dos componentes: activo y pasivo. Todos los identificadores creados por GRTS se rastrean continuamente
tanto en escenarios de depuración como comerciales. Cada vez que se pasan identificadores a nuestras API, la
plataforma realiza una validación para asegurarse de que estos identificadores corresponden a objetos internos válidos. Si
se detecta un identificador no válido, la plataforma registra el error e invoca
[XErrorReport](/reference/system/xerror/functions/xerrorsetoptions) para notificar al desarrollador el problema. La plataforma no
realiza ningún esfuerzo adicional para suprimir el uso del identificador no válido y permite que la aplicación se bloquee
como lo habría hecho antes de esta característica. Por último, cualquier fuga de identificadores en el momento de
[XGameRuntimeUninitialize](/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize) también se notificará mediante
[XErrorReport](/reference/system/xerror/functions/xerrorsetoptions). En la actualidad, el sistema de seguimiento de identificadores no permite el
seguimiento de identificadores externos a GRTS.

## Requisitos

**Encabezado:** XSystem.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Miembros de XSystem](/reference/system/xsystem/xsystem_members)

[XSystemHandleCallback](/reference/system/xsystem/functions/xsystemhandlecallback)


## Related topics

- [XSystemHandleCallback](/es/reference/system/xsystem/functions/xsystemhandlecallback.md)
- [XSystem](/es/reference/system/xsystem/xsystem_members.md)
- [PHEAP_TRACK_FREE_ROUTINE callback](/es/reference/system/xmem/functions/pheap_track_free_routine.md)
- [PHEAP_TRACK_ALLOC_ROUTINE callback](/es/reference/system/xmem/functions/pheap_track_alloc_routine.md)
- [PHEAP_TRACK_REALLOC_ROUTINE callback](/es/reference/system/xmem/functions/pheap_track_realloc_routine.md)