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