> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)


## Related topics

- [XblMultiplayerManagerMatchStatus](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagermatchstatus.md)
- [XblMultiplayerManagerCancelMatch](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerEventArgsFindMatchCompleted](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsfindmatchcompleted.md)
- [multiplayer_manager_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)
- [XblMultiplayerSessionStatus](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionstatus.md)