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
마지막 수정일 2026년 8월 24일