Skip to main content
Habilita programaticamente a depuração dinâmica da GPU em consoles XBOX Series. 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. Esta API é fornecida para habilitar a depuração dinâmica sempre que necessário, não apenas quando há um travamento da GPU com ondas de sombreador presentes. A depuração dinâmica pode ser usada para verificar como a GPU está executando e para inspecionar o conteúdo. Chame esta API antes de ExecuteCommandLists cujo sombreador precisa ser depurado. Esta API está disponível nas versões validada e instrumentada do driver gráfico. A depuração dinâmica será 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 sombreadores 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 dinâmica e os parâmetros específicos desse tipo de depuração. 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_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 e procura o sombreador do tipo e dos parâmetros especificados. Quando ele é encontrado, uma sessão de depuração dinâmica deve ser iniciada. Se não for encontrado, a GPU retoma a execução e o título continua a ser executado. Em ambos os casos, uma mensagem é exibida na janela Saída do Visual Studio. A depuração dinâmica é desabilitada após o término da sessão de depuração dinâmica. Ela também pode ser desabilitada explicitamente chamando a API com o tipo D3D12XBOX_LIVE_DEBUGGING_NONE. Uma API semelhante é fornecida para detectar sombreadores 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 dinâmica. Cabeçalho: d3d12_xs.h
Biblioteca: d3d12_xs.lib
Plataformas com suporte: consoles XBOX Series

Confira também

Membros de d3d12_xs ID3D12CommandQueue ReportGpuHaltX EnableLiveDebuggingX Depuração dinâmica sob demanda no PIX Depuração dinâmica em exceções de sombreador no PIX
Last modified on October 6, 2026