> ## 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

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

<a id="syntaxSection" />

## 語法

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

<a id="parametersSection" />

### 參數

*pszPackageMoniker*<br />類型：LPCWSTR

指向應用程式之套件 Moniker 的指標。

*fEnable*<br />類型：BOOL

指定 TRUE 以啟用偵錯，或指定 FALSE 以停用偵錯。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

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

<a id="remarksSection" />

## 備註

<Note>
  此方法僅適用於 XBOX One Software Development Kit\ERA 遊戲。在 Microsoft Game Development Kit (GDK) 遊戲上叫用此方法沒有任何作用。
</Note>

此方法會為具有 `pszPackageMoniker` 中指定之套件 Moniker 的應用程式套件啟用或停用偵錯，分別設定或清除該套件的偵錯旗標。

<Note>
  您應該只在套件未執行時設定該套件的偵錯旗標。在執行中的套件上設定偵錯旗標可能會產生無法預期的結果。
</Note>

為應用程式套件設定偵錯旗標，會對應用程式套件中的所有應用程式產生下列影響：

* 如果應用程式完成啟用的時間超過 45 秒，應用程式不會被終止。
* 如果應用程式暫停所需時間過長，應用程式不會被終止。獨佔應用程式的限制為 1 秒，共用應用程式的限制為 5 秒。
* 應用程式在失去可見度過久之後不會被暫停。獨佔應用程式的限制為 10 分鐘，共用應用程式的限制為 5 秒。
* 若要暫停應用程式，請叫用 [xbapp suspend (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbapp#xbapp_suspend) 命令，或叫用 [IXtfApplicationClient::Suspend](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows) 函式。
* 當您的應用程式處於偵錯模式時，不受一般處理序生命週期管理 (PLM) 限制的約束，只有在您使用 XBOX Tools Framework (XTF) 工具指示時才會暫停或繼續。

<Note>
  在偵錯模式中，您的應用程式可能會在一般 PLM 程序不會使其暫停的狀態下 (例如在可見時) 被暫停。當您的應用程式在偵錯模式中執行時，測試暫停和繼續行為請務必謹慎，以確保您測試的是正常行為，而不是在偵錯模式中執行的影響。
</Note>

清除應用程式套件的偵錯旗標，會對應用程式套件中的應用程式產生下列影響：

* 如果應用程式完成啟用的時間超過 45 秒，應用程式會被終止。
* 如果應用程式暫停所需時間過長，應用程式會被終止。獨佔應用程式的限制為 1 秒，共用應用程式的限制為 5 秒。
* 應用程式在失去可見度過久之後會被暫停。獨佔應用程式的限制為 10 分鐘，共用應用程式的限制為 5 秒。

偵錯旗標的狀態適用於整個套件。如果單一套件中有多個應用程式且已設定偵錯旗標，則所有應用程式都會在偵錯模式中執行。

將開發套件重新開機會清除偵錯旗標。

從 Visual Studio 執行應用程式並將偵錯工具附加至應用程式處理序 (按 F5 (**偵錯 > 開始偵錯**))，會在應用程式執行之前自動設定偵錯旗標，並在應用程式終止後清除該旗標。執行應用程式但不將偵錯工具附加至應用程式處理序 (按 Ctrl+F5 (**偵錯 > 啟動但不偵錯**))，會在應用程式執行之前清除偵錯旗標，且在應用程式終止後旗標仍保持清除狀態。如果您的應用程式在偵錯模式中當機，且 Visual Studio 已附加至您的應用程式，則 Visual Studio 會在從應用程式中斷連結時清除偵錯旗標。

在下列情況下，偵錯旗標狀態會保持設定：

* 如果應用程式當機，只要當時未附加 Visual Studio 偵錯工具。
* 經過暫停和繼續作業。
* 經過終止，只要當時未附加 Visual Studio 偵錯工具。

如需遊戲生命週期狀態的詳細資訊，請參閱 [XBOX 遊戲生命週期 (NDA 主題)](/zh-TW/build/console-features/console-workflows/xbox-game-life-cycle)。

<a id="requirementsSection" />

## 需求

**標頭：** xtfapplication.h

**程式庫：** xtfapplication.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

<a id="seealsoSection" />

## 另請參閱

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


## Related topics

- [IXtfApplicationClient::Suspend](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows.md)
- [IXtfApplicationClient::DebugQuery](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-debugquery.md)
- [IXtfApplicationClient::EnableGlobalOption](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/enableglobaloption-ixtfapplicationclient-xtfapplication-xb.md)
- [IXtfApplicationClient::Constrain](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Launch](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)