Skip to main content

​
XLaunchNewGame

현재 게임을 종료하고, 할당된 리소스를 해제한 다음, 새 게임을 실행합니다.

​
구문

​
매개 변수

exePath   _In_z_
형식: char* 실행할 새 게임의 경로 및 파일 이름입니다. 이 경로는 현재 디렉터리에 대한 상대 경로이거나 절대 경로일 수 있습니다. 호출 실행 파일의 경로를 알아야 하는 게임은 모듈 핸들에 nullptr을 지정하여 GetModuleFileNameA를 호출할 수 있습니다. args   _In_opt_z_
형식: char* 새 게임을 실행하는 데 사용되는 해당 게임 관련 인수입니다. defaultUser   _In_opt_
형식: XUserHandle 새 게임을 실행하는 사용자의 핸들입니다. 값이 지정되지 않으면 현재 사용자가 지정됩니다.

​
반환 값

형식: void 이 함수는 게임을 다시 시작할 수 없는 경우에도 값을 반환하거나 예외를 발생시키지 않습니다.

​
설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한
내용은 시간에 민감한 스레드를 참조하세요. 이 함수는 게임을 다시 시작하고, 게임의 현재 프로세스를 종료한 다음, 새 프로세스를 사용하여 게임을 다시 시작합니다. 게임이 실행 중인 가상 머신을 다시 시작하지 않고 게임이 다시 시작됩니다. 게임을 다시 시작할 때 다른 기본 사용자와 게임별 인수를 지정할 수 있습니다. 다른 기본 사용자를 지정하는 방법에 대한 자세한 내용은 사용자 ID 및 XUser를 참조하세요. 현재 프로세스는 함수가 새 게임을 시작하는 동안 오류가 발생하더라도 항상 종료됩니다. 예를 들어 exePath, args 또는 defaultUser에 지정된 값이 유효하지 않은 경우에도 함수는 값을 반환하거나 예외를 발생시키지 않습니다.
이 함수를 호출하면 이전에 마운트된 모든 DLC는 마운트 해제됩니다. XLaunchNewGame의
대상을 호스팅하는 DLC는 예외입니다. G: 드라이브는 계속해서 새로 실행된 EXE가 아닌 기본 패키지의 루트를 가리킵니다.
XLaunchNewGame이 호출된 후 새로 실행된 게임이 일시 중단 핸들러를
설정하기 전에 게임이 일시 중단되면 게임이 종료됩니다. 이는 매우 좁은 시간 창이며 실제로는 발생할 가능성이 매우 낮습니다.
XMemTransferMemory(NDA 항목)를 사용하여 시스템으로 전송된 메모리는 유지됩니다.

​
요구 사항

헤더: XGame.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

​
개념 문서

​
함께 보기

XGame
사용자 ID 및 XUser
XLaunchUri
마지막 수정일 2026년 8월 24일

관련 항목

XLaunchRestartOnCrash게임의 기본 사용자 변경Games-as-a-Service(GaaS) 지원XGame사용자 및 입력 장치