Skip to main content

XtfStartTitleOS

지정된 Game OS를 시작하거나 다시 시작합니다.

구문

매개 변수

address
형식: PCWSTR
[in] 콘솔의 주소입니다. osIdentifier
형식: PCWSTR
[in, optional] 시작할 Game OS의 식별자입니다. 이 식별자는 다음 중 하나일 수 있습니다:
  • 시작할 Game OS 버전의 4부 버전 번호를 포함하는 MicrosoftGame.config 파일의 전체 경로와 파일 이름
  • GameOs.xvd 파일의 전체 경로와 파일 이름
  • MicrosoftGame.config 또는 GameOS.vxd 파일이 포함된 디렉터리의 전체 경로
  • 시작할 Game OS의 4부 버전 번호
유효한 식별자의 예:
  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

반환값

형식: HRESULT 성공하면 S_OK를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수를 사용하여 콘솔 캐시에서 지정된 Game OS를 시작하거나 다시 시작합니다. 시작하려는 Game OS의 FourPartVersion이 있는 경우 대신 XtfStartTitleOSByVersion 함수를 사용하여 해당 Game OS 버전을 시작하세요. XtfGetCachedTitleOSVersions 함수를 사용하여 콘솔에 캐시된 각 Game OS의 FourPartVersion을 가져오거나, XtfGetTitleOSFourPartVersion 함수를 사용하여 현재 실행 중인 타이틀의 Game OS에 대한 FourPartVersion을 가져올 수 있습니다. 또한 XtfStartTitleOSByGameConfig 함수를 사용하여 지정된 MicrosoftGame.config 파일 내용에 지정된 Game OS를 시작할 수도 있습니다. 필요한 경우 XtfCacheTitleOS 함수를 호출하여 콘솔 캐시에 Game OS를 추가할 수 있습니다. 프로비저닝된 Game OS 파일 관리에 대한 자세한 내용은 Application Management (xbapp.exe) (NDA topic)Provision (xbprovision.exe) (NDA topic)을 참조하세요.

요구 사항

헤더: xtfapi.h 라이브러리: XtfApi.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)

참고 항목

Run from PC Deployment (NDA topic)
XTF Transport Errors (NDA topic)
Additional Xtf APIs
마지막 수정일 2026년 8월 24일