XblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerSessionWriteMode::SynchronizedUpdate を使用して、ゲーム セッションのホストを設定します。
構文
パラメーター
deviceToken _In_型: char* ホストのデバイス トークン。 context _In_opt_
型: void* 省略可能。XblMultiplayerEvent を発生元の呼び出しに関連付けるためのアプリケーション定義のデータ。
戻り値
型: HRESULT この API 操作の HRESULT 戻り値コード。解説
この関数は、ゲーム セッションのホストを設定します。この関数を使用することで、原子性を保証し、同時にホストを設定しようとしているデバイス間の競合を解決できます。競合が原因でレース条件が発生した場合、サービスはホスト設定のリクエストを拒否することがあります。リクエストが拒否された場合、サービスは
HTTP_E_STATUS_PRECOND_FAILED を返します。競合が発生した場合、ホストを変更する必要性を再評価し、必要に応じてこの関数を再度呼び出してリクエストを再送信します。この関数の結果は、イベント タイプが
XblMultiplayerEventType::SynchronizedHostWriteCompleted に設定されたマルチプレイヤー イベントとして配信されます。XblMultiplayerManagerDoWork を呼び出してマルチプレイヤー イベントを取得できます。ホスト デバイス トークンはセッション メンバーのセキュア デバイス アドレスから生成されるため、このメソッドを呼び出す前に、目的のホストに対してセキュア デバイス アドレスが設定されていることを確認してください。
要件
ヘッダー: multiplayer_manager_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib関連項目
multiplayer_manager_cXblMultiplayerManagerGameSessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress