> ## 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) — Active par programmation le débogage GPU en direct 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 d'activer le débogage en direct chaque fois que c'est nécessaire, et pas seulement lorsqu'un blocage du GPU survient avec des vagues de nuanceurs présentes. Le débogage en direct peut servir à vérifier comment le GPU s'exécute et à inspecter la charge utile. Appelez cette API avant les appels ExecuteCommandLists dont le nuanceur doit être débogué.

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étecter les nuanceurs qui lèvent des exceptions et les déboguer en temps réel. Consultez [EnableLiveDebuggingX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

## Syntaxe

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

### Paramètres

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

Permet de définir le type de débogage en direct et les paramètres propres à ce type de débogage. 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\_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 et recherche le nuanceur du type et des paramètres spécifiés. S'il est trouvé, une session de débogage en direct doit être démarrée. S'il n'est pas trouvé, le GPU reprend son exécution et le titre continue de s'exécuter. Un message s'affiche dans les deux cas dans la fenêtre Sortie de Visual Studio.

Le débogage en direct est désactivé à la fin de la session de débogage en direct. Il peut également être désactivé explicitement en appelant l'API avec le type D3D12XBOX\_LIVE\_DEBUGGING\_NONE.

Une API similaire est fournie pour détecter les nuanceurs qui lèvent des exceptions et les déboguer en temps réel. Consultez [EnableLiveDebuggingX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_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 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)

[ID3D12CommandQueue](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)

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

[EnableLiveDebuggingX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

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

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


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