語法
參數
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另請參閱
PartyXblManagerPartyXblStateChange
PartyXblManager::FinishProcessingStateChanges
