지정된 콘솔 상태에 도달하거나 시간 제한이 발생할 때까지 블록 실행을 차단합니다.
구문
HRESULT XtfWaitForConsoleState(
PCWSTR address,
UINT32 consoleState,
const UINT32 timeoutMS
)
매개 변수
address
형식: PCWSTR
[in] 콘솔의 주소입니다.
consoleState
형식: UINT32
[in] 콘솔의 현재 상태를 나타내는 플래그의 비트 단위 또는 조합입니다. 이 매개 변수는 다음 플래그를 지원합니다.
| 플래그 | 값 | 설명 |
|---|---|---|
| XTF_SYSTEM_OS_READY | 0x0001 | 시스템 OS는 XTF(Xbox Tools Framework) 통신에 사용할 수 있습니다. |
| XTF_TITLE_OS_READY | 0x0002 | 게임 OS는 XTF 통신이 가능합니다. <br>이 플래그는 XtfGetTitleOSState 함수에서 반환하는 XTF_TITLESTATE_TITLEOSRUNNING, XTF_TITLESTATE_TITLENETWORK_READY 플래그와 동일합니다. |
| XTF_TITLE_PROCESS_READY | 0x0004 | 해당 게임에 대한 프로세스는 XTF 통신에 사용할 수 있습니다. <br>이 플래그는 XtfGetTitleOSState 함수에서 반환되는 XTF_TITLESTATE_TITLERUNNING 플래그와 동일합니다. |
timeoutMS
형식: UINT32
[in]함수에서 ERROR_TIMEOUT을 반환하기 전 시간 제한(밀리초)입니다.
반환 값
형식: HRESULT
성공하면 S_OK를 반환하고 그렇지 않으면 S_OK를 반환합니다.
| 오류 코드 | 설명 |
|---|---|
| ERROR_TIMEOUT | timeoutMS에 지정된 시간 제한이 경과하였으며 consoleState에 지정된 상태에 도달하지 않았습니다. |
| E_INVALIDARG | address 또는 consoleState로 전달된 값이 잘못되었습니다. |
주석
이 함수는 250 밀리초마다 루프하여 콘솔의 현재 상태를 consoleState에 지정된 상태와 비교하여 유효성을 검사합니다.
consoleState에 지정된 상태가 timeoutMS에 지정된 시간 내에 콘솔의 현재 상태와 일치하지 않는 경우 이 함수는 ERROR_TIMEOUT를 반환합니다. 그렇지 않으면 이 함수는 루핑를 중지 하고 S_OK을 반환합니다. 시스템 OS 및 게임 OS에 대한 자세한 내용은 Microsoft 게임 개발 키트란?(NDA 항목)을 참조하세요.
요구 사항
헤더: xtfapi.h
라이브러리: XtfApi.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)