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 tampons de commandes dans un proche avenir. 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 alors que des vagues de nuanceurs sont présentes. Le débogage en direct peut servir à vérifier la façon dont le GPU s’exécute et à inspecter la charge utile. Appelez cette API avant un appel de dessin ou un dispatch 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 de processeur est déjà attaché ou si PIX est connecté à la console de développement au moment de l’appel. Une API semblable est offerte pour détecter les nuanceurs qui lèvent des exceptions et les déboguer en temps réel. Consultez EnableLiveDebuggingX

Syntaxe

Paramètres

pDebugParams   _In_opt_
Type : 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 tampons de commandes dans un proche avenir.

Valeur renvoyée

Type : HRESULT Renvoie S_OK en cas de réussite; sinon, renvoie E_FAIL. Renvoie E_NOINTERFACE si aucun débogueur de processeur n’est attaché et que PIX n’est pas connecté. Renvoie 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 de processeur n’est attaché et que PIX n’est pas connecté à la console de développement au moment où l’API est exécutée. 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. Dans les deux cas, un message s’affiche 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 aussi être désactivé explicitement en appelant l’API avec le type D3D12XBOX_LIVE_DEBUGGING_NONE. Une API semblable est offerte pour détecter les nuanceurs qui lèvent des exceptions et les déboguer en temps réel. Consultez EnableLiveDebuggingX

Configuration requise

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