> ## 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 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 de fournir également, dans un avenir proche, le débogage en direct des mémoires tampons de commandes.

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'outils. Appelez cette API avec le type de nuanceur et les indicateurs d'exception appropriés. L'exécution du nuanceur 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é au devkit au moment de l'appel.

Une API similaire est fournie pour déboguer les nuanceurs en temps réel à la demande. Consultez [EnableLiveDebuggingX](/fr/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/reference/graphics/d3d12_xs/structs/d3d12xbox_live_debugging_global_parameters)

Permet de définir le type et les indicateurs qui spécifient la condition dans 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 de fournir également, dans un avenir proche, le débogage en direct des mémoires tampons de commandes.

### 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'outils n'est pas disponible lors de l'activation du débogage en direct sur 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

Sans effet si aucun débogueur CPU n'est attaché et que PIX n'est pas connecté au devkit au moment de l'exécution de l'API.

Le GPU s'arrête si et quand un nuanceur du type spécifié lève l'exception spécifiée. Cela peut se produire 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 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/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/methods/id3d12commandqueue_enablelivedebuggingx)

## Configuration requise

[ReportGpuHaltX](/fr/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_reportgpuhaltx) doit être appelé 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/reference/graphics/d3d12_xs/d3d12_xs_members)

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

[EnableLiveDebuggingX](/fr/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/nda/nda-topic-directory.md)
- [D3D12EnableExperimentalFeatures](/fr/reference/graphics/d3d12/functions/d3d12enableexperimentalfeatures_public.md)
- [D3D12_COLOR_WRITE_ENABLE](/fr/reference/graphics/d3d12/enums/d3d12_color_write_enable_public.md)
- [D3D12_DRED_ENABLEMENT](/fr/reference/graphics/d3d12/enums/d3d12_dred_enablement_public.md)
- [D3D12_SHADER_CACHE_CONTROL_FLAGS (consoles XBOX Series)](/fr/reference/graphics/d3d12/enums/d3d12_shader_cache_control_flags_public.md)