> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfApplicationClient::DebugEnable

> IXtfApplicationClient::DebugEnable

# IXtfApplicationClient::DebugEnable

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

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
public:
HRESULT DebugEnable(
         LPCWSTR pszPackageMoniker,
         BOOL fEnable
)  
```

<a id="parametersSection" />

### Paramètres

*pszPackageMoniker*<br />Type : LPCWSTR

Un pointeur vers le moniker de package de l'application.

*fEnable*<br />Type : BOOL

Spécifiez TRUE pour activer le débogage, ou FALSE pour le désactiver.

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur HRESULT.

<a id="remarksSection" />

## Remarques

<Note>
  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).
</Note>

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.

<Note>
  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.
</Note>

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)](/fr-CA/tools/tools-console/commandlinetools/xbapp#xbapp_suspend) ou la fonction [IXtfApplicationClient::Suspend](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows).
* 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).

<Note>
  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.
</Note>

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)](/fr-CA/build/console-features/console-workflows/xbox-game-life-cycle).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xtfapplication.h

**Bibliothèque :** xtfapplication.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="seealsoSection" />

## Voir aussi

[IXtfApplicationClient](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)<br />[XtfApplication](/fr-CA/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::Suspend](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows.md)
- [IXtfApplicationClient::DebugQuery](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-debugquery.md)
- [IXtfApplicationClient::EnableGlobalOption](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/enableglobaloption-ixtfapplicationclient-xtfapplication-xb.md)
- [IXtfApplicationClient::Constrain](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Terminate](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/terminate-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)