Skip to main content
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

​
Syntaxe

​
Paramètres

pDebugParams   _In_opt_
Type : 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
Une API similaire est fournie pour déboguer les nuanceurs en temps réel, à la demande. Consultez EnableLiveDebuggingX

​
Configuration requise

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 ReportGpuHaltX EnableLiveDebuggingX Débogage en direct sur les exceptions de nuanceur dans PIX Débogage en direct à la demande dans PIX
Last modified on October 6, 2026