跳轉到主要內容
擷取自上次呼叫以來所有要處理的 Party XBOX Live 狀態變更陣列。

語法

參數

stateChangeCount   uint32_t*
輸出
用來寫入 stateChanges 陣列中供遊戲處理之 PartyXblStateChange 項目數目的位置。 stateChanges   PartyXblStateChangeArray*
大小為 *stateChangeCount 的程式庫配置輸出陣列
用來儲存陣列指標的位置,此陣列包含所有供遊戲處理、然後傳遞給 FinishProcessingStateChanges() 的 PartyXblStateChange 項目。

傳回值

PartyError 如果呼叫成功,則為 c_partyErrorSuccess;否則為錯誤碼。可透過 GetErrorMessage() 擷取錯誤碼的人類可讀形式。

備註

此方法讓 Party XBOX Live Helper 程式庫有機會擷取自上次呼叫此方法以來,目前可供遊戲使用的所有變更清單。遊戲應使用所提供的 0 個或多個變更陣列來更新自己的狀態或 UI,然後及時以這些變更呼叫 FinishProcessingStateChanges()。

程式庫公開的狀態可能會在此呼叫期間變更,因此您在使用時必須保持執行緒安全。應經常呼叫 StartProcessingStateChanges(),至少每 100 毫秒一次。其設計目的是快速執行並傳回,因此可以在主要 UI 執行緒上呼叫,且影響可忽略不計。為了獲得最佳結果,您也應盡量縮短在呼叫 FinishProcessingStateChanges() 之前處理狀態變更所花費的時間。

StartProcessingStateChanges() 傳回的每個狀態變更都必須剛好傳回給 FinishProcessingStateChanges() 一次,但可以不依順序傳回,也可以與其他 StartProcessingStateChanges() 呼叫的狀態變更交錯。與特定狀態變更相關聯的任何資源,都保證在該狀態變更傳回給 FinishProcessingStateChanges() 之前保持有效。

需求

標頭: PartyXboxLive.h

另請參閱

PartyXblManager
PartyXblStateChange
PartyXblManager::FinishProcessingStateChanges
最後修改於 2026年10月8日