> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ID3D12Commandqueue::EnableLiveDebuggingX

> ID3D12Commandqueue::EnableLiveDebuggingX (consoles XBOX Series) — Habilita programaticamente a depuração dinâmica da GPU em consoles XBOX Series.

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](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

## Sintaxe

```cpp theme={null}
HRESULT EnableLiveDebuggingX(
  D3D12XBOX_LIVE_DEBUGGING_PARAMETERS * pDebugParams
)
```

### Parâmetros

*pDebugParams*   \_In\_opt\_\
Tipo:  [D3D12XBOX\_LIVE\_DEBUGGING\_PARAMETERS](/pt-BR/reference/graphics/d3d12_xs/structs/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](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

## Requisitos

[ReportGpuHaltX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_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](/pt-BR/reference/graphics/d3d12_xs/d3d12_xs_members)

[ID3D12CommandQueue](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)

[ReportGpuHaltX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_reportgpuhaltx)

[EnableLiveDebuggingX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

[Depuração dinâmica sob demanda no PIX](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/pix/pix-on-demand-live-debugging)

[Depuração dinâmica em exceções de sombreador no PIX](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/pix/pix-shader-exceptions-live-debugging)


## Related topics

- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](/ja-jp/nda/nda-topic-directory.md)