跳轉到主要內容

XtfWaitForConsoleState

封鎖執行,直到達到指定的主機狀態或發生逾時為止。

語法

參數

address
類型:PCWSTR
[in] 主機的位址。 consoleState
類型:UINT32
[in] 旗標的位元 OR 組合,表示主機目前的狀態。此參數支援下列旗標: timeoutMS
類型:UINT32
[in] 函式傳回 ERROR_TIMEOUT 之前的逾時 (以毫秒為單位)。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則會傳回下列其中一個 HRESULT 錯誤碼。

備註

此函式每 250 毫秒循環一次,根據 consoleState 中指定的狀態驗證主機的目前狀態。如果 consoleState 中指定的狀態在 timeoutMS 中指定的時間內與主機的目前狀態不符,函式會傳回 ERROR_TIMEOUT;否則,函式會停止循環並傳回 S_OK。如需 System OS 和 Game OS 的詳細資訊,如需完整的簡介,請參閱什麼是 Microsoft Game Development Kit?(NDA 主題)。

需求

標頭: xtfapi.h 程式庫: XtfApi.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

XTF 傳輸錯誤 (NDA 主題)
其他 Xtf API
最後修改於 2026年10月6日