Skip to main content
Habilita programaticamente a depuração de GPU ao vivo em consoles XBOX Series. Atualmente, a depuração ao vivo está limitada à depuração de shaders. Há planos de estendê-la além dos shaders e fornecer também a depuração ao vivo de buffers de comando em um futuro próximo. Esta API é fornecida para habilitar a depuração ao vivo sempre que necessário, e não apenas quando há um travamento da GPU com waves de shader presentes. A depuração ao vivo pode ser usada para verificar como a GPU está executando e para inspecionar o conteúdo. Chame esta API antes de um draw ou dispatch cujo shader precise ser depurado. Esta API está disponível nas variantes validada e instrumentada do driver gráfico. A depuração ao vivo é habilitada programaticamente se um depurador de CPU já estiver anexado ou se o PIX estiver conectado ao devkit no momento da chamada. Uma API semelhante é fornecida para detectar shaders que geram exceções e depurá-los em tempo real. Consulte EnableLiveDebuggingX

Sintaxe

Parâmetros

pDebugParams   _In_opt_
Tipo: D3D12XBOX_LIVE_DEBUGGING_PARAMETERS
Permite definir o tipo de depuração ao vivo e os parâmetros específicos desse tipo de depuração. Atualmente, a depuração ao vivo está limitada à depuração de shaders. Há planos de estendê-la além dos shaders e fornecer também a depuração ao vivo de buffers de comando em um futuro próximo.

Valor retornado

Tipo: HRESULT Retorna S_OK se bem-sucedido; caso contrário, retorna E_FAIL. Retorna E_NOINTERFACE se um depurador de CPU não estiver anexado e o PIX não estiver conectado. Retorna E_NOTIMPL na variante de varejo do driver, pois este é um recurso para desenvolvedores.

Comentários

Nenhuma operação é executada 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 e procura o shader do tipo e dos parâmetros especificados. Quando encontrado, uma sessão de depuração ao vivo deve ser iniciada. Se não for encontrado, a GPU retoma a execução e o título continua a ser executado. Uma mensagem é exibida em ambos os casos na janela de Saída do Visual Studio. A depuração ao vivo é desabilitada após o término da sessão de depuração ao vivo. Ela também pode ser desabilitada explicitamente chamando a API com o tipo D3D12XBOX_LIVE_DEBUGGING_NONE. Uma API semelhante é fornecida para detectar shaders que geram exceções e depurá-los em tempo real. Consulte EnableLiveDebuggingX

Requisitos

ReportGpuHaltX deve ser chamado para detectar a interrupção da GPU e iniciar a depuração ao vivo. Cabeçalho: d3d12_xs.h
Biblioteca: d3d12_xs.lib
Plataformas compatíveis: consoles XBOX Series

Confira também

Membros de d3d12_xs ID3D12GraphicsCommandList6 ReportGpuHaltX EnableLiveDebuggingX Depuração ao vivo sob demanda no PIX Depuração ao vivo em exceções de shader no PIX
Last modified on October 6, 2026