XblMultiplayerManagerFindMatch
將配對要求提交至伺服器。語法
參數
hopperName _In_z_類型：char* 此要求的 hopper 名稱。 attributesJson _In_opt_z_
類型：char* 選用。此要求之配對票證的屬性，以 JSON 字串表示。 timeoutInSeconds _In_
類型：uint32_t 等候使用者加入配對的最長時間 (以秒為單位)。
傳回值
類型：HRESULT 此 API 作業的 HRESULT 傳回碼。備註
此函式會將大廳工作階段的配對要求提交至 Multiplayer Manager (MPM)。您必須先在遊戲的服務設定中設定 hopper，才能使用此函式。hopper 會定義 SmartMatch 用來配對玩家的規則。如需 hopper 的詳細資訊，請參閱配對概觀。如果大廳工作階段不存在 (可能是因為未呼叫 XblMultiplayerManagerInitialize)，或在呼叫此函式之前未將本機使用者新增至大廳工作階段，就會發生錯誤。如果配對已在進行中，也會發生錯誤。此函式的結果會以事件類型設定為
XblMultiplayerEventType::FindMatchCompleted 的多人遊戲事件傳遞。您可以呼叫 XblMultiplayerManagerDoWork 來擷取多人遊戲事件。
需求
標頭： multiplayer_manager_c.h 程式庫： Microsoft.Xbox.Services.14x.GDK.C.lib另請參閱
multiplayer_manager_cXblMultiplayerManagerEstimatedMatchWaitTime