XtfWaitForConsoleState

Bloqueia a execução até que os estados de console especificados sejam atingidos ou ocorra um tempo limite.

Sintaxe

HRESULT XtfWaitForConsoleState(  
         PCWSTR address,  
         UINT32 consoleState,  
         const UINT32 timeoutMS  
)  

Parâmetros

address
Tipo: PCWSTR [in] O endereço do console. consoleState
Tipo: UINT32 [in] Uma combinação OR bit a bit de sinalizadores que indicam o estado atual do console. Este parâmetro dá suporte aos seguintes sinalizadores:

Sinalizador	Valor	Descrição
XTF_SYSTEM_OS_READY	0x0001	O System OS está pronto para comunicações do XBOX Tools Framework (XTF).
XTF_TITLE_OS_READY	0x0002	O Game OS está pronto para comunicações do XTF.<br>Este sinalizador é equivalente aos sinalizadores `XTF_TITLESTATE_TITLEOSRUNNING` e `XTF_TITLESTATE_TITLENETWORK_READY` retornados pela função XtfGetTitleOSState.
XTF_TITLE_PROCESS_READY	0x0004	O processo do jogo está pronto para comunicações do XTF.<br>Este sinalizador é equivalente ao sinalizador `XTF_TITLESTATE_TITLERUNNING` retornado pela função `XtfGetTitleOSState`.

timeoutMS
Tipo: UINT32 [in] O tempo limite, em milissegundos, antes que a função retorne ERROR_TIMEOUT.

Valor de retorno

Tipo: HRESULT Retorna S_OK se tiver êxito; caso contrário, retorna um dos seguintes códigos de erro HRESULT.

Código de erro	Descrição
ERROR_TIMEOUT	O tempo limite especificado em timeoutMS expirou e os estados especificados em consoleState não foram atingidos.
E_INVALIDARG	Os valores passados em address ou consoleState não eram válidos.

Comentários

Esta função executa um loop a cada 250 milissegundos, validando o estado atual do console em relação aos estados especificados em consoleState. Se os estados especificados em consoleState não corresponderem ao estado atual do console dentro do tempo especificado em timeoutMS, a função retornará ERROR_TIMEOUT; caso contrário, a função interromperá o loop e retornará S_OK. Para obter mais informações sobre o System OS e o Game OS, confira Para uma introdução completa, confira O que é o Microsoft Game Development Kit? (tópico sob NDA).

Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

Erros de transporte do XTF (tópico sob NDA)
APIs adicionais do Xtf

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XtfWaitForConsoleState

XtfWaitForConsoleState

Sintaxe

Parâmetros

Valor de retorno

Comentários

Requisitos

Confira também

​XtfWaitForConsoleState

​Sintaxe

​Parâmetros

​Valor de retorno

​Comentários

​Requisitos

​Confira também

XtfWaitForConsoleState

Sintaxe

Parâmetros

Valor de retorno

Comentários

Requisitos

Confira também