跳轉到主要內容
傳回先前正在處理的 Party XBOX Live 狀態變更陣列。

語法

參數

stateChangeCount   uint32_t 在 stateChanges 所指定清單中提供的變更數目,這些變更先前由 StartProcessingStateChanges() 傳回,且現在已由遊戲處理。 stateChanges   PartyXblStateChangeArray
大小為 stateChangeCount 的輸入陣列
指向變更陣列的指標,這些變更先前由 StartProcessingStateChanges() 傳回,且現在已由遊戲處理。

傳回值

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

備註

此方法會通知 Party XBOX Live Helper 程式庫,先前呼叫 StartProcessingStateChanges() 所回報的狀態變更現在已由遊戲處理,因此可以回收其相關聯的資源。您可以使用任意數目的狀態變更呼叫 FinishProcessingStateChanges()。StartProcessingStateChanges() 傳回的每個狀態變更都必須剛好傳回給 FinishProcessingStateChanges() 一次,但可以不依順序傳回,也可以與其他 StartProcessingStateChanges() 呼叫的狀態變更交錯。即使在後續的 StartProcessingStateChanges() 呼叫期間保留狀態變更,所有 getter 傳回的 Party XBOX Live Helper 程式庫狀態仍會向前推進,可能不再反映所保留之狀態變更所參考的相同狀態。

與特定狀態變更相關聯的任何資源,都保證在該狀態變更傳回給 FinishProcessingStateChanges() 之前保持有效。

為了獲得最佳結果,您應盡量縮短在呼叫 FinishProcessingStateChanges() 之前處理狀態變更所花費的時間。

需求

標頭: PartyXboxLive.h

另請參閱

PartyXblManager
PartyXblStateChange
PartyXblManager::StartProcessingStateChanges
最後修改於 2026年10月20日