Skip to main content

​
IXtfApplicationClient::DebugEnable

Habilita o deshabilita la depuración del paquete de aplicación con el moniker de paquete especificado.

​
Sintaxis

​
Parámetros

pszPackageMoniker
Tipo: LPCWSTR Un puntero al moniker de paquete de la aplicación. fEnable
Tipo: BOOL Especifique TRUE para habilitar la depuración, o FALSE para deshabilitarla.

​
Valor devuelto

Tipo: HRESULT Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.

​
Comentarios

Este método se aplica solamente a los títulos de XBOX One Software Development Kit\ERA. Invocar este método no tiene ningún efecto en los títulos de Microsoft Game Development Kit (GDK).
Este método habilita o deshabilita la depuración del paquete de aplicación con el moniker de paquete especificado en pszPackageMoniker, estableciendo o borrando, respectivamente, la marca de depuración de ese paquete.
Debe establecer la marca de depuración de un paquete solo cuando ese paquete no esté en ejecución. Establecer la marca de depuración en un paquete en ejecución puede producir resultados impredecibles.
Establecer la marca de depuración de un paquete de aplicación tiene los siguientes efectos para todas las aplicaciones del paquete de aplicación:
  • La aplicación no se finaliza si tarda más de 45 segundos en completar la activación.
  • La aplicación no se finaliza si tarda demasiado en suspenderse. El límite es de 1 segundo para una aplicación exclusiva, o de 5 segundos para una aplicación compartida.
  • La aplicación no se suspende tras perder la visibilidad durante demasiado tiempo. El límite es de 10 minutos para las aplicaciones exclusivas, o de 5 segundos para las aplicaciones compartidas.
  • Para suspender la aplicación, invoque el comando xbapp suspend (tema con NDA) o invoque la función IXtfApplicationClient::Suspend.
  • Cuando la aplicación está en modo de depuración, no está sujeta a los límites normales de la administración de la duración de procesos (PLM), y solo se suspenderá o reanudará cuando usted lo indique mediante las herramientas de XBOX Tools Framework (XTF).
En modo de depuración, la aplicación puede suspenderse en estados en los que el proceso normal de PLM no provocaría su suspensión, como cuando está visible. Tenga cuidado al probar el comportamiento de suspensión y reanudación mientras la aplicación se ejecuta en modo de depuración, para asegurarse de que está probando el comportamiento normal y no los efectos de la ejecución en modo de depuración.
Borrar la marca de depuración de un paquete de aplicación tiene los siguientes efectos para las aplicaciones del paquete de aplicación:
  • La aplicación se finaliza si tarda más de 45 segundos en completar la activación.
  • La aplicación se finaliza si tarda demasiado en suspenderse. El límite es de 1 segundo para una aplicación exclusiva, o de 5 segundos para una aplicación compartida.
  • La aplicación se suspende tras perder la visibilidad durante demasiado tiempo. El límite es de 10 minutos para las aplicaciones exclusivas, o de 5 segundos para las aplicaciones compartidas.
El estado de la marca de depuración se aplica a todo el paquete. Si tiene varias aplicaciones en un mismo paquete con la marca de depuración establecida, todas las aplicaciones se ejecutarán en modo de depuración. Reiniciar el kit de desarrollo borra la marca de depuración. Ejecutar la aplicación desde Visual Studio con el depurador asociado al proceso de la aplicación, presionando F5 (Debug > Start Debugging), establece automáticamente la marca de depuración antes de que la aplicación se ejecute y la borra después de que la aplicación finalice. Ejecutar la aplicación sin asociar el depurador al proceso de la aplicación, presionando Ctrl+F5 (Debug > Start Without Debugging), borra la marca de depuración antes de que la aplicación se ejecute, y la marca permanece borrada después de que la aplicación finalice. Si la aplicación se bloquea en modo de depuración y Visual Studio está asociado a la aplicación, Visual Studio borra la marca de depuración cuando se desasocia de la aplicación. El estado de la marca de depuración permanece establecido en las situaciones siguientes:
  • Si la aplicación se bloquea, siempre que el depurador de Visual Studio no esté asociado en ese momento.
  • A través de una operación de suspensión y reanudación.
  • A través de una finalización, siempre que el depurador de Visual Studio no esté asociado en ese momento.
Para obtener más información sobre los estados del ciclo de vida del juego, consulte Ciclo de vida del juego de XBOX (tema con NDA).

​
Requisitos

Encabezado: xtfapplication.h Biblioteca: xtfapplication.lib Plataformas compatibles: Windows (para las herramientas de consola XBOX)

​
Consulte también

IXtfApplicationClient
XtfApplication
Última modificación el 28 de agosto de 2026

Temas relacionados

IXtfApplicationClient::SuspendIXtfApplicationClient::DebugQueryIXtfApplicationClient::EnableGlobalOptionIXtfApplicationClient::ConstrainIXtfApplicationClient::Snap