跳轉到主要內容

​
IXtfApplicationClient::DebugEnable

為具有指定套件 Moniker 的應用程式套件啟用或停用偵錯。

​
語法

​
參數

pszPackageMoniker
類型：LPCWSTR 指向應用程式之套件 Moniker 的指標。 fEnable
類型：BOOL 指定 TRUE 以啟用偵錯，或指定 FALSE 以停用偵錯。

​
傳回值

類型：HRESULT 如果成功，則傳回 S_OK；否則會傳回 HRESULT 錯誤碼。

​
備註

此方法僅適用於 XBOX One Software Development Kit\ERA 遊戲。在 Microsoft Game Development Kit (GDK) 遊戲上叫用此方法沒有任何作用。
此方法會為具有 pszPackageMoniker 中指定之套件 Moniker 的應用程式套件啟用或停用偵錯，分別設定或清除該套件的偵錯旗標。
您應該只在套件未執行時設定該套件的偵錯旗標。在執行中的套件上設定偵錯旗標可能會產生無法預期的結果。
為應用程式套件設定偵錯旗標，會對應用程式套件中的所有應用程式產生下列影響：
  • 如果應用程式完成啟用的時間超過 45 秒，應用程式不會被終止。
  • 如果應用程式暫停所需時間過長，應用程式不會被終止。獨佔應用程式的限制為 1 秒，共用應用程式的限制為 5 秒。
  • 應用程式在失去可見度過久之後不會被暫停。獨佔應用程式的限制為 10 分鐘，共用應用程式的限制為 5 秒。
  • 若要暫停應用程式，請叫用 xbapp suspend (NDA 主題) 命令，或叫用 IXtfApplicationClient::Suspend 函式。
  • 當您的應用程式處於偵錯模式時，不受一般處理序生命週期管理 (PLM) 限制的約束，只有在您使用 XBOX Tools Framework (XTF) 工具指示時才會暫停或繼續。
在偵錯模式中，您的應用程式可能會在一般 PLM 程序不會使其暫停的狀態下 (例如在可見時) 被暫停。當您的應用程式在偵錯模式中執行時，測試暫停和繼續行為請務必謹慎，以確保您測試的是正常行為，而不是在偵錯模式中執行的影響。
清除應用程式套件的偵錯旗標，會對應用程式套件中的應用程式產生下列影響：
  • 如果應用程式完成啟用的時間超過 45 秒，應用程式會被終止。
  • 如果應用程式暫停所需時間過長，應用程式會被終止。獨佔應用程式的限制為 1 秒，共用應用程式的限制為 5 秒。
  • 應用程式在失去可見度過久之後會被暫停。獨佔應用程式的限制為 10 分鐘，共用應用程式的限制為 5 秒。
偵錯旗標的狀態適用於整個套件。如果單一套件中有多個應用程式且已設定偵錯旗標，則所有應用程式都會在偵錯模式中執行。 將開發套件重新開機會清除偵錯旗標。 從 Visual Studio 執行應用程式並將偵錯工具附加至應用程式處理序 (按 F5 (偵錯 > 開始偵錯))，會在應用程式執行之前自動設定偵錯旗標，並在應用程式終止後清除該旗標。執行應用程式但不將偵錯工具附加至應用程式處理序 (按 Ctrl+F5 (偵錯 > 啟動但不偵錯))，會在應用程式執行之前清除偵錯旗標，且在應用程式終止後旗標仍保持清除狀態。如果您的應用程式在偵錯模式中當機，且 Visual Studio 已附加至您的應用程式，則 Visual Studio 會在從應用程式中斷連結時清除偵錯旗標。 在下列情況下，偵錯旗標狀態會保持設定：
  • 如果應用程式當機，只要當時未附加 Visual Studio 偵錯工具。
  • 經過暫停和繼續作業。
  • 經過終止，只要當時未附加 Visual Studio 偵錯工具。
如需遊戲生命週期狀態的詳細資訊，請參閱 XBOX 遊戲生命週期 (NDA 主題)。

​
需求

標頭： xtfapplication.h 程式庫： xtfapplication.lib 支援的平台： Windows (適用於 XBOX 主機工具)

​
另請參閱

IXtfApplicationClient
XtfApplication
最後修改於 2026年10月6日