다음을 통해 공유

XtfWaitForConsoleOSReady

  • 아티클

반환 전 콘솔 OS가 명령을 수신할 준비가 될 때까지 기다립니다.

구문

HRESULT XtfWaitForConsoleOSReady(
         PCWSTR address,
         UINT32 timeoutMS
)

매개 변수

address
형식: PCWSTR

[in] 콘솔의 주소입니다. 주소가 시스템 IP 주소 또는 HostName이면 시스템 OS가 준비될 때까지 API가 차단됩니다. 주소에 /title이 포함된 경우(예: L"123.12.123.24/title"), 게임 OS까 시작될 때까지 API가 차단됩니다.

timeoutMS
형식: UINT32

[in] 제한 시간(밀리초)입니다.

반환 값

형식: HRESULT

성공하면 S_OK가 반환됩니다. 제한 시간이 만료되기 전 OS가 준비되지 않으면 XtfWaitForConsoleOSReady가 ERROR_TIMEOUT을 반환합니다. 지정된 주소가 유효하지 않으면 XtfWaitForConsoleOSReady가 E_INVALIDARG를 반환합니다.

비고

다음 표에서는 본체 상태를 기준으로 이 API의 동작 예를 보여줍니다.

상태

동작

결과

시스템이 작동되어 실행 중임XtfWaitForConsoleOSReady즉시 S_OK 반환
시스템이 작동되어 실행 중임
  • XtfConsoleControlClient::Reboot
  • XtfWaitForConsoleOSReady
  • XtfApplicationClient::Launch
콘솔이 완전히 재부팅될 때까지 XtfWaitForConsoleOSReady가 차단됩니다. 실행이 성공하고 홈으로 제한된 상태로 실행되는 대신 전체 화면으로 실행됩니다.
시스템이 꺼짐XtfWaitForConsoleOSReady제한 시간 동안 XtfWaitForConsoleOSReady가 차단되고 오류를 반환합니다.
시스템이 꺼짐
  • XtfWaitForConsoleOSReady
  • 콘솔 켜기
  • XtfApplicationClient::Launch
콘솔이 완전히 부팅될 때까지 XtfWaitForConsoleOSReady가 차단됩니다. 실행이 성공하고 홈으로 제한된 상태로 실행되는 대신 전체 화면으로 실행됩니다.

요구 사항

헤더: xtfapi.h

라이브러리: XtfApi.lib

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

참고 항목

XtfRegisterPackage
XTF 전송 오류(NDA 항목)
추가 Xtf API