Passer au contenu principal

​
IXtfApplicationClient::DebugEnable

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

​
Syntaxe

​
Paramètres

pszPackageMoniker
Type : LPCWSTR Un 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 du package d’application ayant le 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 sur toutes les applications du package :
  • Il n’est pas mis fin à l’application si elle prend plus de 45 secondes pour terminer son activation.
  • Il n’est pas mis fin à l’application si elle prend trop de temps à se suspendre. 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 sa 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. Faites preuve de prudence lorsque vous testez le comportement de suspension et de reprise pendant 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 sur les applications du package :
  • Il est mis fin à l’application si elle prend plus de 45 secondes pour terminer son activation.
  • Il est mis fin à l’application si elle prend trop de temps à se suspendre. 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 sa 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 ces 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 (Déboguer > Démarrer le débogage), définit automatiquement l’indicateur de débogage avant l’exécution de votre application, puis l’efface après la fin de l’application. L’exécution de votre application sans attacher le débogueur au processus de l’application, en appuyant sur Ctrl+F5 (Déboguer > Exécuter sans débogage), efface l’indicateur de débogage avant l’exécution de votre application, et l’indicateur reste effacé après la fin de votre application. Si votre application plante en mode débogage alors que Visual Studio y est attaché, Visual Studio efface l’indicateur de débogage lorsqu’il se détache de votre application. L’indicateur de débogage reste défini dans les situations suivantes :
  • Si l’application plante, à condition que le débogueur Visual Studio ne soit pas attaché à ce moment-là.
  • Au cours d’une opération de suspension et de reprise.
  • Au cours 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
Dernière modification le 6 octobre 2026

Sujets connexes

IXtfApplicationClient::SuspendIXtfApplicationClient::DebugQueryIXtfApplicationClient::EnableGlobalOptionIXtfApplicationClient::ConstrainIXtfApplicationClient::Launch