PartyXblManager::FinishProcessingStateChanges

処理中だった Party Xbox Live の状態の変化の配列を返します。

構文

PartyError FinishProcessingStateChanges(  
    uint32_t stateChangeCount,  
    PartyXblStateChangeArray stateChanges  
)  

パラメーター

stateChangeCount uint32_t

stateChanges で指定された一覧で提供される変更の数。タイトルによって処理された StartProcessingStateChanges() によって以前に返されました。

stateChanges PartyXblStateChangeArray
サイズ stateChangeCount の入力配列

現在はタイトルが取り扱っており、以前に StartProcessingStateChanges() によって返された変化の配列へのポインター。

戻り値

PartyError

呼び出しが成功した場合は c_partyErrorSuccess、それ以外の場合はエラー コードになります。 人間が判読できる形式のエラー コードは、GetErrorMessage() を介して取得できます。

解説

このメソッドでは、パーティー向け Xbox Live ヘルパー ライブラリに対して、StartProcessingStateChanges() への過去の呼び出しによって報告された状態の変化が現在はタイトルによって処理されていることを通知するため、それらに関連付けられているリソースは再利用が可能です。 FinishProcessingStateChanges() は、任意の数の状態変更で呼び出せます。 StartProcessingStateChanges() によって返される各状態変更は、FinishProcessingStateChanges() に 1 回だけ返す必要がありますが、順不同で返される場合があり、StartProcessingStateChanges() への他の呼び出しからの状態変更とインターリーブされる場合があります。 StartProcessingStateChanges() の後続の呼び出しで状態の変更が保持されている場合でも、すべてのゲッターによって返されるパーティー向け Xbox Live ヘルパー ライブラリの状態が進み、保持状態の変更が参照するのと同じ状態が反映されなくなる可能性があります。

特定の状態変更に関連付けられているリソースは、状態の変更が FinishProcessingStateChanges() に返されるまで有効なままであることが保証されます。

最適な結果を得るためには、FinishProcessingStateChanges() を呼び出す前に状態の変化の処理に費やす時間を最小限に抑える必要があります。

要件

ヘッダー: PartyXboxLive.h

関連項目

PartyXblManager
PartyXblStateChange
PartyXblManager::StartProcessingStateChanges