> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerMatchStatus

> XblMultiplayerMatchStatus

# XblMultiplayerMatchStatus

定义用于指示匹配阶段状态的值。

## 语法

```cpp theme={null}
enum class XblMultiplayerMatchStatus  : uint32_t  
{  
    None,  
    SubmittingMatchTicket,  
    Searching,  
    Found,  
    Joining,  
    WaitingForRemoteClientsToJoin,  
    Measuring,  
    UploadingQosMeasurements,  
    WaitingForRemoteClientsToUploadQos,  
    Evaluating,  
    Completed,  
    Resubmitting,  
    Expired,  
    Canceling,  
    Canceled,  
    Failed,  
}  
```

## 常量

| 常量                                 | 说明                                                      |
| ---------------------------------- | ------------------------------------------------------- |
| None                               | 表示尚未开始匹配搜索。                                             |
| SubmittingMatchTicket              | 表示已提交匹配票证以进行匹配。                                         |
| Searching                          | 表示匹配仍在搜索中。                                              |
| Found                              | 表示匹配搜索已找到匹配项。                                           |
| Joining                            | 加入初始化阶段。匹配创建游戏会话并向其中添加用户。在此阶段，客户端有加入超时时间以加入会话。          |
| WaitingForRemoteClientsToJoin      | 等待远程客户端加入游戏会话。在此阶段，客户端有加入超时时间以加入会话。                     |
| Measuring                          | 测量初始化阶段。此阶段进行 QoS 测量。在此阶段，客户端有测量超时时间以将 qos 测量结果上传到服务。   |
| UploadingQosMeasurements           | 将 QoS 测量结果上传到服务。在此阶段，客户端有测量超时时间以将 qos 测量结果上传到服务。        |
| WaitingForRemoteClientsToUploadQos | 等待远程客户端将 QoS 测量结果上传到服务。在此阶段，客户端有测量超时时间以将 qos 测量结果上传到服务。 |
| Evaluating                         | 评估初始化阶段。如果自动评估为 true，则跳过此阶段。否则，游戏将执行自己的评估。              |
| Completed                          | 找到匹配项且 QoS 测量成功。                                        |
| Resubmitting                       | 如果找到的匹配项不成功并且正在重新提交。                                    |
| Expired                            | 表示匹配搜索已过期。                                              |
| Canceling                          | 表示匹配正在取消搜索。                                             |
| Canceled                           | 表示匹配搜索已取消。                                              |
| Failed                             | 失败的初始化阶段。初始化失败。                                         |

## 要求

**头文件：** multiplayer\_manager\_c.h

## 另请参阅

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)


## Related topics

- [XblMultiplayerManagerMatchStatus](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagermatchstatus.md)
- [XblMultiplayerManagerCancelMatch](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerEventArgsFindMatchCompleted](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsfindmatchcompleted.md)
- [XblMultiplayerSessionStatus](/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionstatus.md)
- [XblMultiplayerSessionMemberStatus](/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionmemberstatus.md)