XblMultiplayerManagerDoWork
タイトルと Multiplayer Manager (MPM) の間でゲーム状態の更新を維持します。構文
パラメーター
multiplayerEvents型: Deref_out_opt ゲームで処理するマルチプレイヤー イベントの配列。この更新中にマルチプレイヤー イベントが発生しない場合、これは null に設定されます。 multiplayerEventsCount _Out_
型: size_t*
multiplayerEvents 配列のサイズ。
戻り値
型: HRESULT この API 操作の HRESULT 戻り値コード。解説
この関数は、タイトルと Multiplayer Manager (MPM) の間でゲーム状態の更新を送受信し、リモート プレイヤーの参加または退出などの重要なマルチプレイヤー イベントを表す XblMultiplayerEvent 構造体の配列を返します。MPM がゲーム状態を適切に維持できるように、この関数はフレームごとに 1 回など、定期的かつ頻繁に呼び出す必要があります。詳細については、「Multiplayer Manager の概要」を参照してください。この関数によって返されるマルチプレイヤー イベントは MPM が所有し、
XblMultiplayerManagerDoWork が再度呼び出されるまでの間のみ有効です。また、この関数が呼び出された時点でゲーム状態が変化するため、タイトルは XblMultiplayerManagerDoWork を呼び出す際にスレッド セーフである必要があります。たとえば、この関数を呼び出しているスレッドとは異なるスレッドでメンバーの一覧を反復処理している場合、この関数が呼び出されたときに一覧が変更される可能性があります。