Skip to main content

​
XSystemHandleTrack

Registra um retorno de chamada para rastrear eventos de tempo de vida de identificadores no Gaming Runtime.

​
Sintaxe

​
Parâmetros

callback    _In_
Tipo: XSystemHandleCallback Um retorno de chamada definido pelo usuário que será chamado na criação e destruição de identificadores. Para desabilitar o rastreamento de identificadores, passe NULL para o retorno de chamada. context    _In_opt_
Tipo: void * Contexto definido pelo usuário a ser passado para o retorno de chamada.

​
Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro.

​
Comentários

Os desenvolvedores de jogos precisam ter a capacidade de solucionar bugs que envolvem o uso incorreto de identificadores. A maioria das APIs do GRTS utiliza identificadores que correspondem ao tempo de vida de objetos internos na nossa implementação da plataforma. Os jogos frequentemente encontram problemas causados por desenvolvedores que, acidentalmente, fornecem identificadores inválidos (NULL, liberados anteriormente etc.) a essas APIs, levando a falhas do título. Os desenvolvedores também podem, inadvertidamente, vazar identificadores, levando ao uso excessivo de recursos. O objetivo da API de rastreamento de identificadores é capacitar os desenvolvedores a diagnosticar e corrigir esses problemas. A API tem dois componentes: ativo e passivo. Todos os identificadores criados pelo GRTS são continuamente rastreados tanto em cenários de depuração quanto de varejo. Sempre que identificadores são passados para nossas APIs, a plataforma executa uma validação para garantir que esses identificadores correspondam a objetos internos válidos. Se um identificador inválido for detectado, a plataforma registrará o erro em log e invocará XErrorReport para notificar o desenvolvedor sobre o problema. A plataforma não faz nenhum esforço adicional para suprimir o uso do identificador inválido e permite que o aplicativo falhe como falharia antes desse recurso. Por fim, quaisquer vazamentos de identificadores no momento de XGameRuntimeUninitialize também serão relatados por meio de XErrorReport. Atualmente, o sistema de rastreamento de identificadores não permite o rastreamento de identificadores externos ao GRTS.

​
Requisitos

Cabeçalho: XSystem.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

​
Confira também

Membros de XSystem XSystemHandleCallback
Last modified on October 6, 2026