Skip to main content

​
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

​
Parámetros

callback    _In_
Tipo: 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 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.

​
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 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 también se notificará mediante XErrorReport. 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 XSystemHandleCallback
Última modificación el 28 de agosto de 2026

Temas relacionados

XSystemHandleCallbackXSystemPHEAP_TRACK_FREE_ROUTINE callbackPHEAP_TRACK_ALLOC_ROUTINE callbackPHEAP_TRACK_REALLOC_ROUTINE callback