XblMultiplayerManagerFindMatch
マッチメイキング リクエストをサーバーに送信します。構文
パラメーター
hopperName _In_z_型: char* このリクエスト用のホッパーの名前。 attributesJson _In_opt_z_
型: char* 省略可能。このリクエストのマッチ チケットの属性 (JSON 文字列)。 timeoutInSeconds _In_
型: uint32_t ユーザーがマッチに参加するのを待機する最大時間 (秒単位)。
戻り値
型: HRESULT この API 操作の HRESULT 戻り値コード。解説
この関数は、ロビー セッションのマッチメイキング リクエストを Multiplayer Manager (MPM) に送信します。この関数を使用するには、まずタイトルのサービス構成でホッパーを構成する必要があります。ホッパーは、SmartMatch がプレイヤーをマッチさせるために使用するルールを定義します。ホッパーの詳細については、「マッチメイキングの概要」を参照してください。ロビー セッションが存在しない場合 (通常は XblMultiplayerManagerInitialize が呼び出されていないため)、またはこの関数を呼び出す前にローカル ユーザーがロビー セッションに追加されていない場合、エラーが発生します。マッチメイキングが既に進行中の場合もエラーが発生します。この関数の結果は、イベント タイプが
XblMultiplayerEventType::FindMatchCompleted に設定されたマルチプレイヤー イベントとして配信されます。XblMultiplayerManagerDoWork を呼び出して、マルチプレイヤー イベントを取得できます。
要件
ヘッダー: multiplayer_manager_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib関連項目
multiplayer_manager_cXblMultiplayerManagerEstimatedMatchWaitTime