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
