Skip to main content

XErrorSetOptions

ゲーミング OS またはゲーミング ランタイムでエラーが発生したときの目的の動作を指定します。

Syntax

Parameters

optionsDebuggerPresent   _In_
型: XErrorOptions
デバッガーがアタッチされているときの目的の動作を指定します。 optionsDebuggerNotPresent   _In_
型: XErrorOptions
デバッガーがアタッチされていないときの目的の動作を指定します。

Return value

型: void

Remarks

この関数は、タイム センシティブ スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
この関数を使用して、ゲーミング OS またはゲーミング ランタイムでエラーが発生したときにゲームがどのように反応するべきかを指定します。既定では、デバッガーがアタッチされていない場合ゲームは何もしませんが、デバッガーがアタッチされている場合はデバッガーにデバッグ メッセージを出力します。 デバッガーがアタッチされ、optionsDebuggerPresent が [XErrorOptions::DebugBreakOnError] に設定されている場合、システムはデバッガーにブレークインし、デバッグ メッセージを出力します。この動作は、ウォッチ ウィンドウでグローバル変数 XErrorDisableDebugBreak の値を true に設定することで一時的に無効にできます。 次の例は、エラー オプションを設定する方法、カスタム エラー コールバックを定義する方法、およびシステムからエラー通知を受け取るためにカスタム コールバックを設定する方法を示します。

Requirements

ヘッダー: XError.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XError members
XErrorOptions
最終更新日 2026年8月24日