XblMultiplayerManagerGameSessionSetSynchronizedHost

  • [アーティクル]

XblMultiplayerSessionWriteMode::SynchronizedUpdate を使用して、ゲーム セッションのホストを設定します。

構文

HRESULT XblMultiplayerManagerGameSessionSetSynchronizedHost(  
         const char* deviceToken,  
         void* context  
)

パラメーター

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_c
XblMultiplayerManagerGameSessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress