> ## 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.

# ID3D12GraphicsCommandlist6::EnableLiveDebuggingX

> ID3D12GraphicsCommandlist6::EnableLiveDebuggingX (consoles XBOX Series) — Habilita programaticamente a depuração de GPU ao vivo em consoles XBOX Series.

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](/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 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](/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 ao vivo.

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[Membros de d3d12\_xs](/pt-BR/reference/graphics/d3d12_xs/d3d12_xs_members)

[ID3D12GraphicsCommandList6](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)

[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 ao vivo 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 ao vivo em exceções de shader 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 topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [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)