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 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 NaNConfiguration requise
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.hBibliothèque : d3d12_xs.lib
Plateformes prises en charge : consoles XBOX Series