다음을 통해 공유

XtfStartTitleOS

  • 아티클

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

구문

HRESULT XtfStartTitleOS(
         PCWSTR address,
         PCWSTR osIdentifier
)

매개 변수

address
형식: PCWSTR

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

osIdentifier
형식: PCWSTR

[in, optional] 시작할 게임 OS의 식별자입니다. 이 식별자는 다음 중 하나입니다.

  • 시작할 게임 OS 버전의 4부분 버전 번호가 포함된 MicrosoftGame.config 파일의 전체 경로와 파일 이름
  • GameOs.xvd 파일의 전체 경로와 파일 이름
  • MicrosoftGame.config 또는 GameOS.vxd 파일을 포함하는 디렉터리에 대한 전체 경로
  • 시작할 Game OS의 네 부분으로 된 버전 번호

유효한 식별자 예시:

  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

반환 값

형식: HRESULT

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

설명

이 함수를 사용하여 콘솔의 캐시에서 지정된 게임 OS를 시작하거나 다시 시작합니다.

시작하려는 게임 OS에 대해 FourPartVersion이 있는 경우에는 대신 XtfStartTitleOSByVersion 함수를 사용하여 해당 게임 OS 버전을 시작합니다. XtfGetCachedTitleOSVersions 함수를 사용하여 콘솔에서 캐시된 각 게임 OS의 FourPartVersion을(를) 가져오거나, XtfGetTitleOSFourPartVersion 함수를 사용하여 현재 실행 중인 타이틀에 대한 게임 OS의 FourPartVersion을(를) 가져옵니다. 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