XblMultiplayerManagerJoinGameFromLobby
Crée une nouvelle session de jeu pour la session de salon, ou rejoint une session de jeu existante s’il en existe une pour la session de salon.Syntaxe
Paramètres
sessionTemplateName _In_z_Type : char* Le nom du modèle de session sur lequel la session de jeu doit être basée.
Valeur de retour
Type : HRESULT Code de retour HRESULT pour cette opération d’API.Remarques
Cette fonction crée une nouvelle session de jeu et ajoute les membres actuels de la session de salon à la session de jeu, si aucune session de jeu n’existe déjà. Si un nouvel utilisateur rejoint la session de salon après la création d’une session de jeu, cette fonction trouve la session de jeu existante dans le Multiplayer Session Directory (MPSD) à l’aide d’un handle de transfert dans la session de salon, puis ajoute le nouvel utilisateur à la session de jeu à l’aide de ce handle de transfert. Pour plus d’informations, consultez Vue d’ensemble des concepts multijoueurs. Si aucune session de salon n’existe, probablement parce que XblMultiplayerManagerInitialize n’a pas été appelée avant cette fonction, une erreur se produit. Une erreur se produit également si un matchmaking est en cours. Cette fonction ne migre pas les propriétés existantes de la session de salon vers la session de jeu.Le résultat de cette fonction est transmis sous forme d’événement multijoueur dont le type d’événement est défini sur
XblMultiplayerEventType::JoinGameCompleted. Vous pouvez appeler XblMultiplayerManagerDoWork pour récupérer les événements multijoueurs. Lors d’une tentative de connexion à une session de salon, le service renvoie
HTTP_E_STATUS_BAD_REQUEST si le serveur est plein. Après avoir rejoint la session, vous pouvez définir les propriétés de la session de jeu en appelant XblMultiplayerManagerGameSessionSetProperties ou XblMultiplayerManagerGameSessionSetSynchronizedProperties, ou vous pouvez définir l’hôte de la session de jeu en appelant XblMultiplayerManagerGameSessionSetSynchronizedHost.
Configuration requise
En-tête : multiplayer_manager_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.libVoir aussi
multiplayer_manager_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGame
XblMultiplayerManagerJoinLobby