Skip to main content

​
IXtfApplicationClient::DebugEnable

Active ou désactive le débogage pour le package d’application doté du moniker de package spécifié.

​
Syntaxe

​
Paramètres

pszPackageMoniker
Type : LPCWSTR Pointeur vers le moniker de package de l’application. fEnable
Type : BOOL Spécifiez TRUE pour activer le débogage, ou FALSE pour le désactiver.

​
Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur HRESULT.

​
Remarques

Cette méthode s’applique uniquement aux titres XBOX One Software Development Kit\ERA. L’appel de cette méthode n’a aucun effet sur les titres Microsoft Game Development Kit (GDK).
Cette méthode active ou désactive le débogage pour le package d’application doté du moniker de package spécifié dans pszPackageMoniker, en définissant ou en effaçant respectivement l’indicateur de débogage de ce package.
Vous ne devez définir l’indicateur de débogage d’un package que lorsque ce package n’est pas en cours d’exécution. La définition de l’indicateur de débogage sur un package en cours d’exécution peut produire des résultats imprévisibles.
La définition de l’indicateur de débogage d’un package d’application a les effets suivants pour toutes les applications du package :
  • L’application n’est pas arrêtée si son activation prend plus de 45 secondes.
  • L’application n’est pas arrêtée si sa suspension prend trop de temps. La limite est de 1 seconde pour une application exclusive, ou de 5 secondes pour une application partagée.
  • L’application n’est pas suspendue après avoir perdu la visibilité trop longtemps. La limite est de 10 minutes pour les applications exclusives, ou de 5 secondes pour les applications partagées.
  • Pour suspendre l’application, appelez la commande xbapp suspend (rubrique sous NDA) ou la fonction IXtfApplicationClient::Suspend.
  • Lorsque votre application est en mode débogage, elle n’est pas soumise aux limites normales de la gestion de la durée de vie des processus (PLM) et ne se suspend ou ne reprend que lorsque vous le lui demandez à l’aide des outils XBOX Tools Framework (XTF).
En mode débogage, votre application peut être suspendue dans des états où le processus PLM normal ne la suspendrait pas, par exemple lorsqu’elle est visible. Soyez prudent lorsque vous testez le comportement de suspension et de reprise alors que votre application s’exécute en mode débogage, afin de vous assurer que vous testez le comportement normal et non les effets de l’exécution en mode débogage.
L’effacement de l’indicateur de débogage d’un package d’application a les effets suivants pour les applications du package :
  • L’application est arrêtée si son activation prend plus de 45 secondes.
  • L’application est arrêtée si sa suspension prend trop de temps. La limite est de 1 seconde pour une application exclusive, ou de 5 secondes pour une application partagée.
  • L’application est suspendue après avoir perdu la visibilité trop longtemps. La limite est de 10 minutes pour les applications exclusives, ou de 5 secondes pour les applications partagées.
L’état de l’indicateur de débogage s’applique à l’ensemble du package. Si plusieurs applications se trouvent dans un même package dont l’indicateur de débogage est défini, toutes les applications s’exécutent en mode débogage. Le redémarrage de votre kit de développement efface l’indicateur de débogage. L’exécution de votre application à partir de Visual Studio avec le débogueur attaché au processus de l’application, en appuyant sur F5 (Debug > Start Debugging), définit automatiquement l’indicateur de débogage avant l’exécution de votre application et l’efface après l’arrêt de l’application. L’exécution de votre application sans attacher le débogueur au processus de l’application, en appuyant sur Ctrl+F5 (Debug > Start Without Debugging), efface l’indicateur de débogage avant l’exécution de votre application, et l’indicateur reste effacé après l’arrêt de votre application. Si votre application se bloque en mode débogage alors que Visual Studio y est attaché, Visual Studio efface l’indicateur de débogage lorsqu’il est détaché de votre application. L’indicateur de débogage reste défini dans les situations suivantes :
  • Si l’application se bloque, à condition que le débogueur Visual Studio ne soit pas attaché à ce moment-là.
  • Lors d’une opération de suspension et de reprise.
  • Lors d’un arrêt, à condition que le débogueur Visual Studio ne soit pas attaché à ce moment-là.
Pour plus d’informations sur les états du cycle de vie d’un jeu, consultez Cycle de vie d’un jeu XBOX (rubrique sous NDA).

​
Configuration requise

En-tête : xtfapplication.h Bibliothèque : xtfapplication.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

​
Voir aussi

IXtfApplicationClient
XtfApplication
Last modified on October 6, 2026