Skip to main content

XErrorSetOptions

指定在遊戲 OS 或遊戲執行階段發生錯誤時所需的行為。

語法

參數

optionsDebuggerPresent   _In_
類型:XErrorOptions
指定附加偵錯工具時所需的行為。 optionsDebuggerNotPresent   _In_
類型:XErrorOptions
指定未附加偵錯工具時所需的行為。

傳回值

類型:void

備註

在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感的執行緒。
使用此函式來指定遊戲 OS 或遊戲執行階段發生錯誤時遊戲應如何回應。根據預設,若未附加偵錯工具,遊戲不會執行任何動作;若已附加偵錯工具,則會將偵錯訊息輸出至偵錯工具。 如果已附加偵錯工具,且 optionsDebuggerPresent 設定為 [XErrorOptions::DebugBreakOnError],系統會中斷進入偵錯工具並輸出偵錯訊息。您可以透過監看式視窗將全域變數 XErrorDisableDebugBreak 的值設定為 true,以暫時停用此行為。 下列範例說明如何設定錯誤選項、定義自訂錯誤回呼,以及設定自訂回呼以接收系統的錯誤通知。

需求

標頭: XError.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XError 成員
XErrorOptions
Last modified on October 6, 2026