構文
パラメーター
stateChangeCount uint32_t*出力
stateChanges 配列内でタイトルが処理すべき PartyXblStateChange エントリの数を書き込む場所。
stateChanges PartyXblStateChangeArray*サイズ
*stateChangeCount のライブラリ割り当て出力配列
タイトルが処理して FinishProcessingStateChanges() に渡すべき、すべての PartyXblStateChange エントリの配列へのポインターを格納する場所。
戻り値
PartyError 呼び出しが成功した場合はc_partyErrorSuccess、それ以外の場合はエラー コードを返します。エラー コードの人間が読める形式は、GetErrorMessage() を使用して取得できます。
解説
このメソッドは、Party XBOX Live Helper ライブラリに対して、前回の呼び出し以降タイトルが利用できるすべての変更のリストを取得する機会を提供します。タイトルは、提供された 0 個以上の変更を含む配列を使用して自身の状態や UI を更新し、その後速やかに FinishProcessingStateChanges() にそれらを渡す必要があります。ライブラリによって公開される状態はこの呼び出し中に変わる可能性があるため、その使用にあたってはスレッド セーフである必要があります。StartProcessingStateChanges() は頻繁に、少なくとも 100 ミリ秒に 1 回は呼び出す必要があります。このメソッドは、無視できる影響でメイン UI スレッド上で呼び出せるように、迅速に実行して返却するよう設計されています。最適な結果を得るには、FinishProcessingStateChanges() を呼び出す前に状態変更の処理に費やす時間も最小限に抑える必要があります。
StartProcessingStateChanges() によって返される各状態変更は、必ず 1 回だけ FinishProcessingStateChanges() に返却する必要がありますが、順不同で返してもよく、他の StartProcessingStateChanges() 呼び出しからの状態変更と交互に返しても構いません。特定の状態変更に関連付けられたリソースは、その状態変更が FinishProcessingStateChanges() に返されるまで有効であることが保証されます。
要件
ヘッダー: PartyXboxLive.h関連項目
PartyXblManagerPartyXblStateChange
PartyXblManager::FinishProcessingStateChanges