Pular para o conteúdo principal

​
IXtfApplicationClient::DebugEnable

Habilita ou desabilita a depuração do pacote do aplicativo com o moniker de pacote especificado.

​
Sintaxe

​
Parâmetros

pszPackageMoniker
Tipo: LPCWSTR Um ponteiro para o moniker de pacote do aplicativo. fEnable
Tipo: BOOL Especifique TRUE para habilitar a depuração ou FALSE para desabilitá-la.

​
Valor de retorno

Tipo: HRESULT Retorna S_OK se tiver êxito; caso contrário, retorna um código de erro HRESULT.

​
Comentários

Este método se aplica somente a títulos do XBOX One Software Development Kit\ERA. Invocar este método não tem efeito em títulos do Microsoft Game Development Kit (GDK).
Este método habilita ou desabilita a depuração do pacote do aplicativo com o moniker de pacote especificado em pszPackageMoniker, definindo ou limpando, respectivamente, o sinalizador de depuração desse pacote.
Você só deve definir o sinalizador de depuração de um pacote quando esse pacote não estiver em execução. Definir o sinalizador de depuração em um pacote em execução pode gerar resultados imprevisíveis.
Definir o sinalizador de depuração de um pacote do aplicativo tem os seguintes efeitos para todos os aplicativos no pacote:
  • O aplicativo não é encerrado se levar mais de 45 segundos para concluir a ativação.
  • O aplicativo não é encerrado se demorar demais para suspender. O limite é de 1 segundo para um aplicativo exclusivo ou 5 segundos para um aplicativo compartilhado.
  • O aplicativo não é suspenso depois de perder a visibilidade por muito tempo. O limite é de 10 minutos para aplicativos exclusivos ou 5 segundos para aplicativos compartilhados.
  • Para suspender o aplicativo, invoque o comando xbapp suspend (tópico sob NDA) ou invoque a função IXtfApplicationClient::Suspend.
  • Quando seu aplicativo está no modo de depuração, ele não está sujeito aos limites normais do Gerenciamento do Tempo de Vida do Processo (PLM) e só será suspenso ou retomado quando você o instruir a fazer isso usando as ferramentas do XBOX Tools Framework (XTF).
No modo de depuração, seu aplicativo pode ser suspenso em estados nos quais o processo normal do PLM não o suspenderia, como quando ele está visível. Tenha cuidado ao testar o comportamento de suspensão e retomada enquanto seu aplicativo está em execução no modo de depuração, para garantir que você esteja testando o comportamento normal e não os efeitos da execução no modo de depuração.
Limpar o sinalizador de depuração de um pacote do aplicativo tem os seguintes efeitos para os aplicativos no pacote:
  • O aplicativo é encerrado se levar mais de 45 segundos para concluir a ativação.
  • O aplicativo é encerrado se demorar demais para suspender. O limite é de 1 segundo para um aplicativo exclusivo ou 5 segundos para um aplicativo compartilhado.
  • O aplicativo é suspenso depois de perder a visibilidade por muito tempo. O limite é de 10 minutos para aplicativos exclusivos ou 5 segundos para aplicativos compartilhados.
O estado do sinalizador de depuração se aplica a todo o pacote. Se você tiver vários aplicativos em um único pacote com o sinalizador de depuração definido, todos os aplicativos serão executados no modo de depuração. Reinicializar seu kit de desenvolvimento limpa o sinalizador de depuração. Executar seu aplicativo no Visual Studio com o depurador anexado ao processo do aplicativo, pressionando F5 (Depurar > Iniciar Depuração), define automaticamente o sinalizador de depuração antes que seu aplicativo seja executado e limpa o sinalizador depois que o aplicativo é encerrado. Executar seu aplicativo sem anexar o depurador ao processo do aplicativo, pressionando Ctrl+F5 (Depurar > Iniciar Sem Depuração), limpa o sinalizador de depuração antes que seu aplicativo seja executado, e o sinalizador permanece limpo depois que seu aplicativo é encerrado. Se seu aplicativo falhar no modo de depuração e o Visual Studio estiver anexado ao seu aplicativo, o Visual Studio limpará o sinalizador de depuração quando for desanexado do seu aplicativo. O estado do sinalizador de depuração permanece definido nas seguintes situações:
  • Se o aplicativo falhar, desde que o depurador do Visual Studio não esteja anexado no momento.
  • Durante uma operação de suspensão e retomada.
  • Durante um encerramento, desde que o depurador do Visual Studio não esteja anexado no momento.
Para obter mais informações sobre os estados do ciclo de vida do jogo, confira Ciclo de vida de jogos do XBOX (tópico sob NDA).

​
Requisitos

Cabeçalho: xtfapplication.h Biblioteca: xtfapplication.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

​
Confira também

IXtfApplicationClient
XtfApplication
Última modificação em 6 de outubro de 2026