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

> Active par programmation le débogage GPU en direct sur les exceptions sur les consoles XBOX Series.

Active par programmation le débogage GPU en direct sur les consoles XBOX Series. Le débogage en direct est actuellement limité au débogage des nuanceurs. Il est prévu de l'étendre au-delà des nuanceurs et d'offrir également le débogage en direct des mémoires tampons de commandes dans un avenir proche.

Cette API permet de détecter les nuanceurs qui lèvent des exceptions et de les déboguer en temps réel. Elle alloue 64 Ko de mémoire d'outillage. Appelez cette API avec le type de nuanceur et les indicateurs d'exception appropriés. L'exécution des nuanceurs s'arrête chaque fois que l'exception spécifiée est levée par un nuanceur du type spécifié.

Cette API est disponible dans les versions validée et instrumentée du pilote graphique. Le débogage en direct est activé par programmation si un débogueur CPU est déjà attaché ou si PIX est connecté à la console de développement au moment de l'appel.

Une API similaire est fournie pour déboguer les nuanceurs en temps réel, à la demande. Consultez [EnableLiveDebuggingX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_enablelivedebuggingx)

## Syntaxe

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

### Paramètres

*pDebugParams*   \_In\_opt\_\
Type : [D3D12XBOX\_LIVE\_DEBUGGING\_GLOBAL\_PARAMETERS](/fr-CA/reference/graphics/d3d12_xs/structs/d3d12xbox_live_debugging_global_parameters)

Permet de définir le type et les indicateurs qui spécifient la condition pour laquelle le débogage en direct doit être activé. Le débogage en direct est actuellement limité au débogage des nuanceurs. Il est prévu de l'étendre au-delà des nuanceurs et d'offrir également le débogage en direct des mémoires tampons de commandes dans un avenir proche.

### Valeur de retour

Type : HRESULT

Retourne S\_OK en cas de réussite; sinon, retourne E\_FAIL.

Retourne E\_OUTOFMEMORY si la mémoire d'outillage n'est pas disponible lors de l'activation du débogage en direct sur les exceptions.

Retourne E\_NOINTERFACE si aucun débogueur CPU n'est attaché et que PIX n'est pas connecté.

Retourne E\_NOTIMPL dans la version commerciale du pilote, car il s'agit d'une fonctionnalité destinée aux développeurs.

## Remarques

Aucune opération n'est effectuée si ni le débogueur CPU n'est attaché ni PIX n'est connecté à la console de développement au moment de l'exécution de l'API.

Le GPU s'arrête si un nuanceur du type spécifié lève l'exception spécifiée, au moment où cela se produit. Cela peut survenir immédiatement après l'appel de l'API ou après plusieurs minutes. Une session de débogage en direct doit être démarrée lorsque le GPU s'arrête.

Le GPU ne s'arrête pas et le titre poursuit son exécution si aucun nuanceur du type spécifié ne lève l'exception spécifiée.

À partir du GDK d'octobre 2023, le débogage en direct sur les exceptions reste activé après la fin de la session de débogage en direct. Il peut être désactivé explicitement en appelant l'API avec le type D3D12XBOX\_LIVE\_DEBUGGING\_NONE.

Exemple - Activer le débogage en direct lorsqu'un nuanceur lève une exception 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);
```

Une API similaire est fournie pour déboguer les nuanceurs en temps réel, à la demande. Consultez [EnableLiveDebuggingX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_enablelivedebuggingx)

## Configuration requise

[ReportGpuHaltX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_reportgpuhaltx) doit être appelée pour détecter l'arrêt du GPU sur les exceptions de nuanceur et démarrer le débogage en direct.

**En-tête :** d3d12\_xs.h\
**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[Membres de d3d12\_xs](/fr-CA/reference/graphics/d3d12_xs/d3d12_xs_members)

[ReportGpuHaltX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_reportgpuhaltx)

[EnableLiveDebuggingX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_enablelivedebuggingx)

[Débogage en direct sur les exceptions de nuanceur dans PIX](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/pix/pix-shader-exceptions-live-debugging)

[Débogage en direct à la demande dans 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)