XblMultiplayerManagerFindMatch
Soumet une demande de matchmaking au serveur.Syntaxe
Paramètres
hopperName _In_z_Type : char* Nom de la trémie (hopper) pour cette demande. attributesJson _In_opt_z_
Type : char* Facultatif. Attributs du ticket de match pour cette demande, sous forme de chaîne JSON. timeoutInSeconds _In_
Type : uint32_t Durée maximale, en secondes, d’attente que les utilisateurs rejoignent le match.
Valeur de retour
Type : HRESULT Code de retour HRESULT pour cette opération d’API.Remarques
Cette fonction soumet une demande de matchmaking pour la session de salle d’attente à Multiplayer Manager (MPM). Avant de pouvoir utiliser cette fonction, vous devez d’abord configurer des trémies dans la configuration de service de votre titre. Une trémie définit les règles utilisées par SmartMatch pour associer les joueurs. Pour plus d’informations sur les trémies, consultez Vue d’ensemble du matchmaking. Si aucune session de salle d’attente n’existe, probablement parce que XblMultiplayerManagerInitialize n’a pas été appelée, ou si les utilisateurs locaux n’ont pas été ajoutés à la session de salle d’attente avant l’appel de cette fonction, une erreur se produit. Une erreur se produit également si un matchmaking est déjà en cours.Le résultat de cette fonction est fourni sous la forme d’un événement multijoueur dont le type d’événement est défini sur
XblMultiplayerEventType::FindMatchCompleted. Vous pouvez appeler XblMultiplayerManagerDoWork pour récupérer les événements multijoueurs.
Configuration requise
En-tête : multiplayer_manager_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.libVoir aussi
multiplayer_manager_cXblMultiplayerManagerEstimatedMatchWaitTime