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

# ID3D12Device11::EnableLiveDebuggingX (consoles XBOX Series)

> Habilita programaticamente a depuração dinâmica da GPU em exceções 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 detectar sombreadores que geram exceções e depurá-los em tempo real. Ela aloca 64 KB de memória de ferramentas. Chame esta API com o tipo de sombreador e os sinalizadores de exceção apropriados. A execução do sombreador é interrompida sempre que a exceção especificada é gerada por qualquer sombreador do tipo especificado.

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 depurar sombreadores em tempo real sob demanda. Consulte [EnableLiveDebuggingX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_enablelivedebuggingx)

## Sintaxe

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

### Parâmetros

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

```cpp theme={null}
D3D12XBOX_LIVE_DEBUGGING_GLOBAL_PARAMETERS liveDebugParams{ 0 };
liveDebugParams.Type = D3D12XBOX_LIVE_DEBUGGING_SHADER_STAGE_ANY;
liveDebugParams.Flags = D3D12XBOX_LIVE_DEBUGGING_SHADER_GLOBAL_FLAGS_NAN;
pDevice11->EnableLiveDebuggingX(&liveDebugParams);
```

Uma API semelhante é fornecida para depurar sombreadores em tempo real sob demanda. Consulte [EnableLiveDebuggingX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_enablelivedebuggingx)

## Requisitos

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

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

[EnableLiveDebuggingX](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_enablelivedebuggingx)

[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)

[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)


## Related topics

- [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)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)