XblMultiplayerManagerJoinGameFromLobby
為大廳工作階段建立新的遊戲工作階段;如果大廳工作階段已有遊戲工作階段,則加入該現有的遊戲工作階段。語法
參數
sessionTemplateName _In_z_類型:char* 遊戲工作階段所依據的工作階段範本名稱。
傳回值
類型:HRESULT 此 API 作業的 HRESULT 傳回碼。備註
如果遊戲工作階段尚不存在,此函式會建立新的遊戲工作階段,並將大廳工作階段目前的成員新增至遊戲工作階段。如果在遊戲工作階段建立之後有新使用者加入大廳工作階段,此函式會使用大廳工作階段中的傳輸控制代碼,在 Multiplayer Session Directory (MPSD) 中尋找現有的遊戲工作階段,然後使用該傳輸控制代碼將新使用者新增至遊戲工作階段。如需詳細資訊,請參閱多人遊戲概念概觀。如果大廳工作階段不存在 (可能是因為在呼叫此函式之前未呼叫 XblMultiplayerManagerInitialize),就會發生錯誤。如果配對正在進行中,也會發生錯誤。此函式不會將現有的大廳工作階段屬性移轉至遊戲工作階段。此函式的結果會以多人遊戲事件的形式傳遞,其事件類型設定為
XblMultiplayerEventType::JoinGameCompleted。您可以呼叫 XblMultiplayerManagerDoWork 來擷取多人遊戲事件。嘗試加入大廳工作階段時,如果伺服器已滿,服務會傳回
HTTP_E_STATUS_BAD_REQUEST。加入之後,您可以呼叫 XblMultiplayerManagerGameSessionSetProperties 或 XblMultiplayerManagerGameSessionSetSynchronizedProperties 來設定遊戲工作階段的屬性,或呼叫 XblMultiplayerManagerGameSessionSetSynchronizedHost 來設定遊戲工作階段的主機。
需求
標頭: multiplayer_manager_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib另請參閱
multiplayer_manager_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGame
XblMultiplayerManagerJoinLobby
