Skip to main content

XGameRuntimeInitialize

Gaming Runtime을 초기화합니다.

구문

매개 변수

없음.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요. Gaming Runtime 라이브러리(xgameruntime.dll)를 찾지 못해 함수가 실패하면 반환 값은 E_GAMERUNTIME_DLL_NOT_FOUND로 설정됩니다.

설명

게임에서 Gaming Runtime 기능을 사용하려면 먼저 XGameRuntimeInitialize 함수를 호출하여 Gaming Runtime을 초기화합니다. XGameRuntimeInitialize 함수를 최대한 일찍, 일반적으로 게임의 진입점 함수 내에서 호출합니다. 마찬가지로, 게임이 종료되기 전이지만 가능한 한 늦게 XGameRuntimeUninitialize 함수를 호출하여 Gaming Runtime을 초기화 해제합니다. 게임 런타임에 컴파일 및 링크되는 각 바이너리는 시작 초기에 XGameRuntimeInitialize를 호출해야 합니다. 여기에는 게임 바이너리와 Gaming Runtime 기능을 사용하는 DLL 형태의 미들웨어가 포함됩니다. XGameRuntimeInitialize 함수의 내부에서는 타이틀이 컴파일된 모든 인터페이스의 버전이 확인되며 일치하는 런타임 서비스를 초기화하는 데 사용됩니다. Gaming Runtime의 두 가지 다른 버전 사이에서, 함수가 추가되거나 제거되거나 드물게 호환성이 깨지는 동작 변경이 있을 수 있습니다. 각 구성 요소에서 XGameRuntimeInitialize를 호출하면 같은 프로세스 내에서 로드되는 두 개의 다른 바이너리에서 두 개의 다르고 호환되지 않는 버전의 게임 런타임에 대해 컴파일하는 것과 같은 빌드 구성 문제를 감지하는 데 도움이 됩니다. 이러한 호환되지 않는 구성은 E_GAMERUNTIME_VERSION_MISMATCH 오류를 발생시킵니다. 다음 예제는 Visual Studio의 Direct3D 12 Desktop Game 템플릿을 기반으로 하는 게임의 진입점 함수 내에서 XGameRuntimeInitializeXGameRuntimeUninitialize 함수를 사용하는 방법을 보여 줍니다. XGameRuntimeInitialize 함수는 Game 개체가 인스턴스화되고 등록되기 전에 호출되며, XGameRuntimeUninitialize 함수는 Game 개체가 재설정된 후 진입점 함수가 반환되기 전에 호출됩니다.

요구 사항

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

개념 문서

함께 보기

XGameRuntimeUninitialize
XGameRuntimeInitializeWithOptions
XGameRuntimeInit
XGameRuntime 구조체
XGameRuntime 열거형
Gaming Runtime을 사용한 새 타이틀 개발
마지막 수정일 2026년 8월 24일