構文
パラメーター
handle PFMultiplayerHandle
PFMultiplayer API インスタンスのハンドル。
stateChangeCount uint32_t*出力 タイトルが
stateChanges 配列で処理する PFLobbyStateChange エントリの出力数。
stateChanges PFLobbyStateChange* const**ライブラリが割り当てる
*stateChangeCount サイズの出力配列
タイトルが処理し、その後 PFMultiplayerFinishProcessingLobbyStateChanges() に渡す、すべての PFLobbyStateChange エントリを含むライブラリ割り当ての出力配列。
戻り値
型: HRESULT 呼び出しが成功した場合はS_OK、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、PFMultiplayerGetErrorMessage() を通じて取得できます。
解説
このメソッドは、リモート デバイスやサービスと状態を同期する機会をロビー ライブラリに与え、前回このメソッドを呼び出して以降にタイトルが利用できるすべての変更のリストを取得します。タイトルは、提供された 0 個以上の変更の配列を使って自身の状態や UI を更新し、その後、速やかに PFMultiplayerFinishProcessingLobbyStateChanges() にこれらを渡す必要があります。ライブラリから公開されるロビー ライブラリの状態は、この呼び出し中に変化する可能性があるため、その使用ではスレッド セーフである必要があります。たとえば、UI スレッドで PFMultiplayerStartProcessingLobbyStateChanges() を呼び出しつつ、別のワーカー スレッドで PFLobbyGetMembers() が返したロビー メンバーの一覧をループしていると、PFMultiplayerStartProcessingLobbyStateChanges() がメンバー一覧に関連付けられたメモリを変更する可能性があるためクラッシュを引き起こす場合があります。PFMultiplayerStartProcessingLobbyStateChanges() は頻繁に、少なくとも 1 グラフィックス フレームごとに 1 回呼び出す必要があります。無視できる程度の影響でメイン UI スレッドから呼び出せるように、素早く実行して戻るように設計されています。最良の結果を得るには、PFMultiplayerFinishProcessingLobbyStateChanges() を呼び出すまでの状態変化の処理時間も最小限に抑える必要があります。
PFMultiplayerStartProcessingLobbyStateChanges() が返した各状態変化は、必ず 1 回だけ PFMultiplayerFinishProcessingLobbyStateChanges() に返却する必要がありますが、順不同でも構わず、他の PFMultiplayerStartProcessingLobbyStateChanges() 呼び出しの状態変化と交互に返却してもかまいません。特定の状態変化に関連するリソースは、その状態変化が PFMultiplayerFinishProcessingLobbyStateChanges() に返却されるまで有効であることが保証されます。
要件
ヘッダー: PFLobby.h関連項目
PFLobby メンバーPFLobbyStateChange
PFMultiplayerFinishProcessingLobbyStateChanges