Sintaxe
Parâmetros
pDebugParams _In_opt_Tipo: D3D12XBOX_LIVE_DEBUGGING_GLOBAL_PARAMETERS Permite definir o tipo e os sinalizadores que especificam a condição para a qual a depuração dinâmica deve ser habilitada. Atualmente, a depuração dinâmica está limitada à depuração de sombreadores. Há planos para estendê-la além dos sombreadores e fornecer também a depuração dinâmica de buffers de comando em um futuro próximo.
Valor retornado
Tipo: HRESULT Retorna S_OK se tiver êxito; caso contrário, retorna E_FAIL. Retorna E_OUTOFMEMORY se a memória de ferramentas não estiver disponível ao habilitar a depuração dinâmica em exceções. Retorna E_NOINTERFACE se um depurador de CPU não estiver anexado e o PIX não estiver conectado. Retorna E_NOTIMPL na versão de varejo do driver, pois este é um recurso para desenvolvedores.Comentários
Nenhuma operação será realizada se nem o depurador de CPU estiver anexado nem o PIX estiver conectado ao devkit no momento em que a API for executada. A GPU é interrompida se e quando qualquer sombreador do tipo especificado gerar a exceção especificada. Isso pode ocorrer imediatamente após a chamada da API ou depois de vários minutos. Uma sessão de depuração dinâmica deve ser iniciada quando a GPU é interrompida. A GPU não é interrompida e o título continua a execução se nenhum sombreador do tipo especificado gerar a exceção especificada. A partir do GDK de outubro de 2023, a depuração dinâmica em exceções permanece habilitada após o término da sessão de depuração dinâmica. Ela pode ser desabilitada explicitamente chamando a API com o tipo D3D12XBOX_LIVE_DEBUGGING_NONE. Exemplo - Habilitar a depuração dinâmica quando qualquer sombreador gerar uma exceção de NaNRequisitos
ReportGpuHaltX deve ser chamado para detectar a interrupção da GPU em exceções de sombreador e iniciar a depuração dinâmica. Cabeçalho: d3d12_xs.hBiblioteca: d3d12_xs.lib
Plataformas com suporte: consoles XBOX Series