다음을 통해 공유


XtfStartTitleOSByVersion

콘솔의 캐시에서 지정된 FourPartVersion과 일치하는 게임 OS를 시작하거나 다시 시작합니다.

구문

HRESULT XtfStartTitleOSByVersion(
         PCWSTR address,
         FourPartVersion version
)  

매개 변수

address
형식: PCWSTR

[in] 콘솔의 주소입니다.

version
유형: FourPartVersion

[in] 시작할 게임 OS의 네 부분으로 구성된 버전 정보입니다.

반환 값

형식: HRESULT

성공한 경우 S_OK을(를) 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수를 사용하여 콘솔의 캐시에서 지정된 FourPartVersion과(와) 일치하는 게임 OS를 시작하거나 다시 시작합니다. XtfGetCachedTitleOSVersions 함수를 사용하여 콘솔에서 캐시된 각 게임 OS의 FourPartVersion을(를) 가져오거나, XtfGetTitleOSFourPartVersion 함수를 사용하여 현재 실행 중인 타이틀에 관한 게임 OS의 FourPartVersion을(를) 가져옵니다.

시작하거나 다시 시작할 게임 OS의 FourPartVersion이 없는 경우에는 대신 XtfStartTitleOS 함수를 사용하여 다른 식별자(예: 게임 OS용 GameOs.vxd 파일의 전체 경로 및 파일 이름)를 지정함으로써 게임 OS를 시작하거나 다시 시작합니다. XtfStartTitleOSByGameConfig 함수를 사용하여 MicrosoftGame.config 파일의 지정 내용에 식별된 게임 OS를 시작하거나 다시 시작할 수도 있습니다.

필요한 경우 XtfCacheTitleOS 함수를 호출하여 콘솔의 캐시에 게임 OS를 추가할 수 있습니다. 프로비저닝된 게임 OS 파일 관리에 관한 자세한 내용은 응용 프로그램 관리(xbapp.exe)(NDA 항목)권한 부여 필요프로비전(xbprovision.exe)(NDA 항목)권한 부여 필요을 참조하세요.

요구 사항

헤더: xtfapi.h

라이브러리: XtfApi.lib

지원되는 플랫폼: Windows(Xbox 콘솔 도구용)

참고 항목

PC 배포에서 실행(NDA 항목)권한 부여 필요
XTF 전송 오류(NDA 항목)권한 부여 필요
추가 Xtf API