> ## 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.

# 错误代码

> 在 XGameErr.h 中声明的 GDK 错误代码常量，按子系统组织，HRESULT 值按数值排序，方便 XBOX 与 PC 开发者查找。

Microsoft Game Development Kit (GDK) 错误代码值的常量定义，声明于 XGameErr.h 中。

本概述按子系统组织，每个表格按 `HRESULT` 值递增排序，方便按数值查找。

有关工具和平台 `HRESULT` 的全面覆盖信息（包括启动、部署和诊断工具场景），请参阅 [错误查找 (xberror.exe)](/tools/tools-console/commandlinetools/xberror)。

## 游戏运行时

| 代码                                           | 值          | 说明                                                  | 来源                                                                                                     | 故障排除                                          |
| -------------------------------------------- | ---------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| E\_GAME\_MISSING\_GAME\_CONFIG               | 0x87E5001F | 此应用缺少必需的 MicrosoftGame.Config 文件。                   | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 向包中添加有效的 MicrosoftGame.config 文件，然后重新生成/重新部署。 |
| E\_GAMERUNTIME\_NOT\_INITIALIZED             | 0x89240100 | 游戏运行时未初始化。                                          | [XGameRuntime](/reference/system/xgameruntimeinit/xgameruntimeinit_members)                            | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_DLL\_NOT\_FOUND              | 0x89240101 | 未找到游戏运行时 DLL。                                       | [XGameRuntime](/reference/system/xgameruntimeinit/xgameruntimeinit_members)                            | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_VERSION\_MISMATCH            | 0x89240102 | 游戏运行时 DLL 不支持此版本的 GDK。                              | [XGameRuntime](/reference/system/xgameruntimeinit/xgameruntimeinit_members)                            | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_WINDOW\_NOT\_FOREGROUND      | 0x89240103 | 此操作需要应用窗口位于前台。                                      |                                                                                                        | 将应用窗口置于前台，然后重试该操作。                            |
| E\_GAMERUNTIME\_SUSPENDED                    | 0x89240104 | 游戏运行时处于挂起状态。                                        | [XBOX 游戏生命周期](/build/console-features/console-workflows/xbox-game-life-cycle)                          | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_UNINITIALIZE\_ACTIVEOBJECTS  | 0x89240105 | 在 XGameRuntimeUninitialize 时游戏运行时存在活动对象。            | [XGameRuntimeUninitialize](/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize)      | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_MULTIPLAYER\_NOT\_CONFIGURED | 0x89240106 | 服务上未为此用户在此标题设置多人游戏活动。                               | [XBOX 服务多人游戏](/services/xbox-services/multiplayer/overviews/live-multiplayer-intro)                    | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_OPTIONS\_MISMATCH            | 0x89240109 | 运行时已使用一组不同的选项进行初始化。请先执行 Uninitialize，然后再使用新选项重新初始化。 | [XGameRuntimeUninitialize](/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize)      | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_OPTIONS\_NOT\_SUPPORTED      | 0x8924010A | 传入的选项与游戏包不兼容。游戏配置信息必须与包相匹配。                         | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_GAMECONFIG\_BAD\_FORMAT      | 0x8924010B | 传递给 Initialize 的游戏配置无法解析。                           | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |
| E\_GAMERUNTIME\_INVALID\_HANDLE              | 0x8924010C | 句柄在跨运行时初始化时无法使用。                                    |                                                                                                        | 在重试之前，验证运行时的 init/uninit 顺序、包兼容性以及应用状态。       |

## 游戏用户

| 代码                                                | 值          | 说明                                                                    | 来源                                                                                                     | 故障排除                       |
| ------------------------------------------------- | ---------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | -------------------------- |
| E\_GAMEUSER\_MAX\_USERS\_ADDED                    | 0x89245100 | 无法添加此用户，因为已达到最大用户数量。                                                  | [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync)                                       | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_SIGNED\_OUT                          | 0x89245101 | 无法执行操作，因为该用户已注销。                                                      | [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync)                                       | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED       | 0x89245102 | 需要 UI 来解决此用户的问题。                                                      | [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync)         | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_DEFERRAL\_NOT\_AVAILABLE             | 0x89245103 | 此时不宜请求延迟。                                                             | [XUserGetTokenAndSignatureAsync](/reference/system/xuser/functions/xusergettokenandsignatureasync)     | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_USER\_NOT\_FOUND                     | 0x89245104 | 找不到与该 ID 匹配的用户。                                                       |                                                                                                        | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_TOKEN\_REQUIRED                  | 0x89245105 | 此调用不需要令牌。                                                             |                                                                                                        | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_DEFAULT\_USER                    | 0x89245106 | 当前没有默认用户。如果收到此错误，请在不使用 AddDefaultUserSilently 的情况下再次调用 XUserAddAsync。 | [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync)                                       | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_FAILED\_TO\_RESOLVE                  | 0x89245107 | 无法解析给定的特权。                                                            |                                                                                                        | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_TITLE\_ID                        | 0x89245108 | 必须配置 XBOX Live TitleId。                                               | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_UNKNOWN\_GAME\_IDENTITY              | 0x89245109 | 游戏标识未被识别。MSAAppId 和 TitleId 与游戏关联的不匹配。                                | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_NO\_PACKAGE\_IDENTITY                | 0x89245110 | 必须配置包标识。                                                              | [合作伙伴中心初始配置](/publishing/xstore-commerce/xstore-initial-configuration#1-reserving-a-name)              | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_FAILED\_TO\_GET\_TOKEN               | 0x89245111 | 令牌请求失败。                                                               |                                                                                                        | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_INVALID\_APP\_CONFIGURATION          | 0x89245112 | 游戏配置中的 MSAAppId 无效或未针对身份验证堆栈进行配置。                                     | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_MALFORMED\_MSAAPPID                  | 0x89245113 | 游戏配置中的 MSAAppId 与预期格式不匹配（16 字符字符串或 GUID）。                             |                                                                                                        | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |
| E\_GAMEUSER\_INCONSISTENT\_MSAAPPID\_AND\_TITLEID | 0x89245114 | 游戏配置中的 MSAAppId 和 TitleId 与游戏关联的不匹配。                                  | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) | 验证登录/默认用户/标题标识配置，然后重试用户流程。 |

## 游戏包

| 代码                                                                 | 值          | 说明                                                                                                                                                                       | 来源                                                                                                         | 故障排除                                       |
| ------------------------------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| E\_GAMEPACKAGE\_APP\_NOT\_PACKAGED                                 | 0x89245200 | 游戏未打包到容器中。                                                                                                                                                               |                                                                                                            | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_NO\_INSTALLED\_LANGUAGES                           | 0x89245201 | 游戏使用智能分发有选择地安装语言，但未安装任何语言。                                                                                                                                               | [Intelligent Delivery 语言](/build/core-features/common/packaging/intelligentdelivery-language)              | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_NO\_STORE\_ID                                      | 0x89245202 | 必须在应用的游戏配置中设置 StoreId 属性。                                                                                                                                                | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_INVALID\_SELECTOR                                  | 0x89245203 | 提供的区块选择器无法解析为包中的区块。                                                                                                                                                      | [Chunk 元素参考](/build/core-features/common/packaging/deployment/deployment-element-chunk)                    | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_DOWNLOAD\_REQUIRED                                 | 0x89245204 | 必须下载一个或多个所需的区块，才能在此设备上装载该包。                                                                                                                                              |                                                                                                            | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_NO\_TAG\_CHANGE                                    | 0x89245205 | 请使用 Features 而非 tags 更改此包中已安装的区块。                                                                                                                                        | [Intelligent Delivery recipes](/build/core-features/common/packaging/intelligentdelivery-features-recipes) | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_DLC\_NOT\_SUPPORTED                                | 0x89245206 | 游戏不支持该 DLC 包。请确保游戏配置中的 DLC 兼容性正确。                                                                                                                                        | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_DUPLICATE\_ID\_VALUES                              | 0x89245207 | 包中包含多个映射到相同 'ID' 属性的可执行文件。请检查 'Executable' 元素中是否存在重复的 'ID' 属性。                                                                                                           | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_NO\_PACKAGE\_IDENTIFIER                            | 0x89245208 | 无法解析包的标识符。该包可能未安装。                                                                                                                                                       |                                                                                                            | 验证包安装/内容状态，并在重新部署所需资源后重试。                  |
| E\_GAMEPACKAGE\_CONFIG\_NO\_ROOT\_NODE                             | 0x89245209 | 在 MicrosoftGame.config 文件中找不到根 `Game` 节点。请检查该文件格式是否正确。                                                                                                                   | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_ZERO\_VERSION                              | 0x8924520A | MicrosoftGame.config 中 'Identity' 节点的 'Version' 属性不能为 0.0.0.0。请递增或移除此属性。如果未指定版本，则默认为 1.0.0.0。                                                                            |                                                                                                            | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_NO\_MSAAPPID\_NOTITLEID                    | 0x8924520B | MicrosoftGame.config 中缺少 'MSAAppId' 或 'TitleId' 元素。当 configVersion >= 1 时，必须同时指定这两者。                                                                                     | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_DEPRECATED\_PC\_ENTRIES                    | 0x8924520C | 在 configVersion >= 1 中，DesktopRegistration 条目 "modFolder"、"enableWritesToPackageRoot"、"disableRegistryWriteVirtualization" 和 "disableFilesystemWriteVirtualization" 已弃用。 |                                                                                                            | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_SUM\_REQUIRES\_MSAAPPID                    | 0x8924520D | 当使用简化用户模型（AdvancedUserModel 元素）且 configVersion >= 1 时，必须提供 'MSAAppId' 和 'TitleId' 元素。                                                                                    | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_NO\_CODE\_CLOUD\_SAVES\_REQUIRES\_MSAAPPID | 0x8924520E | 当使用无代码云保存（NoCodePCRoot 元素）且 configVersion >= 1 时，必须提供 'MSAAppId' 和 'TitleId' 元素。                                                                                         | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |
| E\_GAMEPACKAGE\_CONFIG\_MSAAPPID\_OR\_TITLEID\_IS\_DEFAULT         | 0x8924520F | 'MSAAppId' 或 'TitleId' 元素为默认值。如果指定了 NoCodePCRoot 或 AdvancedUserModel，则在使用 configVersion >= 1 时，TitleId 和 MSAAppId 都必须是来自合作伙伴中心的有效 ID。                                    | [MicrosoftGame.config 元素参考](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)     | 更正 MicrosoftGame.config 架构/值，然后重新生成/重新部署包。 |

## 游戏商店

| 代码                                                          | 值          | 说明                                                 | 来源                                                       | 故障排除                     |
| ----------------------------------------------------------- | ---------- | -------------------------------------------------- | -------------------------------------------------------- | ------------------------ |
| E\_GAMESTORE\_LICENSE\_ACTION\_NOT\_APPLICABLE\_TO\_PRODUCT | 0x89245300 | 游戏为无法授权的产品请求了许可。                                   | [XStore 概述](/publishing/xstore-commerce/xstore-overview) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_NETWORK\_ERROR                                | 0x89245301 | 游戏无法与商店网络通信。                                       | [XStore 概述](/publishing/xstore-commerce/xstore-overview) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_SERVER\_ERROR                                 | 0x89245302 | 游戏从商店服务器收到了错误的响应。                                  | [XStore 概述](/publishing/xstore-commerce/xstore-overview) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_INSUFFICIENT\_QUANTITY                        | 0x89245303 | 用户所拥有的此消耗品数量不足以使用所请求的数量。                           | [XStore 概述](/publishing/xstore-commerce/xstore-overview) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_ALREADY\_PURCHASED                            | 0x89245304 | 用户已拥有此产品。                                          | [XStore 概述](/publishing/xstore-commerce/xstore-overview) | 验证商店连接性、权益/许可证状态，然后重试请求。 |
| E\_GAMESTORE\_LICENSE\_ACTION\_THROTTLED                    | 0x89245305 | 游戏对该产品的许可查询过于频繁，现已被限流。同一产品在 10 分钟内的许可尝试次数上限为 30 次。 | [XStore 概述](/publishing/xstore-commerce/xstore-overview) | 验证商店连接性、权益/许可证状态，然后重试请求。 |

## 游戏流式传输

| 代码                                           | 值          | 说明                                                               | 来源                                                                                              | 故障排除                         |
| -------------------------------------------- | ---------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------- |
| E\_GAMESTREAMING\_NOT\_INITIALIZED           | 0x89245400 | XGameStreaming 运行时未初始化。请在调用其他 API 之前调用 XGameStreamingInitialize。 | [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize) | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |
| E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED     | 0x89245401 | 指定的客户端未连接。                                                       |                                                                                                 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |
| E\_GAMESTREAMING\_NO\_DATA                   | 0x89245402 | 请求的数据不可用。数据稍后可能可用。                                               |                                                                                                 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |
| E\_GAMESTREAMING\_NO\_DATACENTER             | 0x89245403 | 当前计算机未在数据中心中运行。                                                  |                                                                                                 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |
| E\_GAMESTREAMING\_NOT\_STREAMING\_CONTROLLER | 0x89245404 | 当前读数并非来自流式传输控制器。                                                 |                                                                                                 | 确保流式传输已初始化且客户端/会话上下文有效，然后重试。 |

## 游戏保存

| 代码                                        | 值          | 说明                                                         | 来源                                                         | 故障排除                                                                                  |
| ----------------------------------------- | ---------- | ---------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| E\_GS\_INVALID\_CONTAINER\_NAME           | 0x80830001 | 容器名称无效。有效的容器名称字符包括大小写字母、数字、下划线和正斜杠。                        | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_NO\_ACCESS                         | 0x80830002 | 操作失败，因为标题无权访问容器存储空间。请检查 SCID 和 TitleId 是否配置正确。             | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE            | 0x80830003 | 设备没有足够的存储容量来保存游戏。                                          | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_USER\_CANCELED                     | 0x80830004 | 用户取消了游戏存档的下载。                                              | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_UPDATE\_TOO\_BIG                   | 0x80830005 | 存档更新的大小过大。XGameSave 更新的总大小必须小于 GS\_MAX\_BLOB\_SIZE（16 MB）。 | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_QUOTA\_EXCEEDED                    | 0x80830006 | 此用户在该标题的存储配额已超出。                                           | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL       | 0x80830007 | 提供给 API 的缓冲区过小。                                            | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_BLOB\_NOT\_FOUND                   | 0x80830008 | 找不到指定的 blob。                                               | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_NO\_SERVICE\_CONFIGURATION         | 0x80830009 | 标题未针对连接存储正确配置。请检查 SCID 是否正确，以及标题是否在合作伙伴中心配置。               | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC           | 0x8083000A | 容器尚未同步。请确保 XGameSave 容器在提交更新之前已完成同步。                       | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_CONTAINER\_SYNC\_FAILED            | 0x8083000B | 容器同步失败。                                                    | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | 用户的 MSA 尚未成为 XBOX 服务账户。                                    | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_HANDLE\_EXPIRED                    | 0x8083000D | 函数使用的句柄已过期，必须重新获取。                                         | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED          | 0x8083000E | 此同步函数正在时间敏感线程上调用，可能导致死锁。请改用异步实现。                           | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |
| E\_GS\_PROVIDER\_MISMATCH                 | 0x8083000F | 游戏混合使用了 XGameSave 与 XGameSaveFiles 调用，这是不支持的。              | [XGameSave](/reference/system/xgamesave/xgamesave_members) | 有关详细的故障排除指导，请参阅 [游戏保存调试](/build/core-features/common/game-save/game-saves-debugging)。 |

## 全局

| 代码                         | 值          | 说明                 | 来源                                                                           | 故障排除                       |
| -------------------------- | ---------- | ------------------ | ---------------------------------------------------------------------------- | -------------------------- |
| S\_OK                      | 0x00000000 | 操作成功完成。            | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 无需操作。                      |
| E\_PENDING                 | 0x8000000A | 操作已启动但尚未完成。        | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 等待完成，然后再次查询异步结果。           |
| E\_BOUNDS                  | 0x8000000B | 提供的索引或范围超出有效边界。    | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 在重试之前验证索引和范围边界。            |
| E\_NOTIMPL                 | 0x80004001 | 未实现此功能。            | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 请为此平台和运行时使用受支持的 API 路径。    |
| E\_NOINTERFACE             | 0x80004002 | 请求的接口在此对象上不可用。     | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 在查询此接口之前验证接口的可用性/版本。       |
| E\_POINTER                 | 0x80004003 | 必需的指针为空或无效。        | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 在调用之前验证所有指针/句柄和对象生存期。      |
| E\_ABORT                   | 0x80004004 | 操作在完成之前被中止。        | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 检查取消/关闭状态，稳定后重新运行。         |
| E\_FAIL                    | 0x80004005 | 操作失败，出现未指定的错误。     | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 查阅日志中先前的失败信息，并在更正输入/状态后重试。 |
| E\_UNEXPECTED              | 0x8000FFFF | 发生了意外的内部错误。        | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 捕获诊断信息，重启该场景，如可重现则上报。      |
| E\_ACCESSDENIED            | 0x80070005 | 拒绝访问所请求的资源或操作。     | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 验证权限、功能和用户/账户上下文，然后重试。     |
| E\_OUTOFMEMORY             | 0x8007000E | 由于无法满足内存分配，操作失败。   | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 减小内存压力、释放分配后重试。            |
| E\_NOT\_SUPPORTED          | 0x80070032 | 当前上下文不支持此操作。       | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 请在当前上下文中使用受支持的操作。          |
| E\_INVALIDARG              | 0x80070057 | 一个或多个参数无效。         | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 在重试之前验证参数值以及必需的组合。         |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x8007007A | 提供的缓冲区对请求的数据来说过小。  | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 查询所需大小、调整缓冲区大小后重试。         |
| E\_TIME\_CRITICAL\_THREAD  | 0x800701A0 | 不允许在时间关键线程上调用。     | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 将此调用移出时间关键线程；可用时请使用异步模式。   |
| E\_NO\_TASK\_QUEUE         | 0x800701AB | 未为该操作提供或没有可用的任务队列。 | [XBOX Live HRESULT 错误代码（全局）](/reference/live/xbl-hresult-error-codes#global) | 在调用此操作之前提供有效的任务队列。         |

## HTTP 客户端

| 代码                                         | 值          | 说明                            | 来源                                                                                          | 故障排除                                        |
| ------------------------------------------ | ---------- | ----------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------- |
| HTTP\_E\_STATUS\_UNEXPECTED                | 0x80190001 | HTTP 客户端遇到意外的协议/状态状况。         | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_UNEXPECTED\_SERVER\_ERROR | 0x80190005 | 服务器返回了意外的错误状况。                | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_AMBIGUOUS                 | 0x8019012C | HTTP 响应表示存在多个匹配资源。            | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_MOVED                     | 0x8019012D | HTTP 重定向指示资源已移动。              | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REDIRECT                  | 0x8019012E | 收到 HTTP 重定向响应。                | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REDIRECT\_METHOD          | 0x8019012F | 需要更改方法的 HTTP 重定向。             | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NOT\_MODIFIED             | 0x80190130 | HTTP 304：自条件请求以来资源未发生变化。      | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_USE\_PROXY                | 0x80190131 | HTTP 请求必须通过代理发送。              | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REDIRECT\_KEEP\_VERB      | 0x80190133 | 保留原始方法/动词的 HTTP 重定向。          | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_BAD\_REQUEST              | 0x80190190 | HTTP 400：请求格式错误或无效。           | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_DENIED                    | 0x80190191 | HTTP 401：请求未经授权或被拒绝。          | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_PAYMENT\_REQ              | 0x80190192 | HTTP 402：此请求需要付款。             | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_FORBIDDEN                 | 0x80190193 | HTTP 403：禁止访问此资源。             | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NOT\_FOUND                | 0x80190194 | HTTP 404：未找到所请求的资源。           | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_BAD\_METHOD               | 0x80190195 | HTTP 方法对此终结点无效。               | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NONE\_ACCEPTABLE          | 0x80190196 | HTTP 406：没有可接受的表示形式可用。        | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_PROXY\_AUTH\_REQ          | 0x80190197 | HTTP 407：需要代理身份验证。            | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REQUEST\_TIMEOUT          | 0x80190198 | HTTP 408：服务器等待请求时超时。          | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_CONFLICT                  | 0x80190199 | HTTP 409：请求与当前服务器状态冲突。        | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_GONE                      | 0x8019019A | HTTP 410：所请求的资源不再可用。          | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_LENGTH\_REQUIRED          | 0x8019019B | HTTP 411：需要提供 Content-Length。 | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_PRECOND\_FAILED           | 0x8019019C | HTTP 412：请求先决条件失败。            | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_REQUEST\_TOO\_LARGE       | 0x8019019D | HTTP 413：请求负载过大。              | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_URI\_TOO\_LONG            | 0x8019019E | HTTP 414：请求 URI 过长。           | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_UNSUPPORTED\_MEDIA        | 0x8019019F | HTTP 415：不支持该媒体类型。            | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_RANGE\_NOT\_SATISFIABLE   | 0x801901A0 | HTTP 416：无法满足请求的范围。           | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_EXPECTATION\_FAILED       | 0x801901A1 | HTTP 417：服务器无法满足请求期望。         | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| FGRL (Rate Limit) Exceeded                 | 0x801901AD | 因超出速率限制，请求被限流。                | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 降低请求速率，并在冷却后使用指数退避策略重试。                     |
| HTTP\_E\_STATUS\_SERVER\_ERROR             | 0x801901F4 | HTTP 500：服务器遇到内部错误。           | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_NOT\_SUPPORTED            | 0x801901F5 | 请求的 HTTP 功能不受支持。              | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_BAD\_GATEWAY              | 0x801901F6 | HTTP 502：从上游服务器收到无效响应。        | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_SERVICE\_UNAVAIL          | 0x801901F7 | HTTP 503：服务暂时不可用。             | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_GATEWAY\_TIMEOUT          | 0x801901F8 | HTTP 504：上游服务器超时。             | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| HTTP\_E\_STATUS\_VERSION\_NOT\_SUP         | 0x801901F9 | 服务器不支持该 HTTP 版本。              | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 检查 HTTP 状态/响应正文，修正请求/身份验证/配置，对瞬时故障使用退避策略重试。 |
| ONL\_E\_ACTION\_REQUIRED                   | 0x8086000C | 操作继续之前需要用户或标题采取行动。            | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 完成服务指示的必要用户/标题操作，然后重试。                      |
| WEB\_E\_UNEXPECTED\_CONTENT                | 0x83750005 | 响应内容与预期格式不匹配。                 | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 验证响应格式/内容类型和服务协定，然后重试。                      |
| WEB\_E\_INVALID\_JSON\_STRING              | 0x83750007 | JSON 负载无效或格式错误。               | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 在发送或解析之前验证 JSON 负载的架构/编码。                   |
| E\_HC\_NOT\_INITIALISED                    | 0x89235001 | HTTP 客户端运行时未初始化。              | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 在发出请求之前初始化 HTTP 客户端运行时。                     |
| E\_HC\_PERFORM\_ALREADY\_CALLED            | 0x89235003 | 此 HTTP 操作已执行过。                | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 为另一次 perform 调用创建新的请求对象。                    |
| E\_HC\_ALREADY\_INITIALISED                | 0x89235004 | HTTP 客户端运行时已初始化。              | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 避免重复初始化；在每个进程生命周期中仅初始化一次。                   |
| E\_HC\_CONNECT\_ALREADY\_CALLED            | 0x89235005 | 此 WebSocket/会话上已调用过 Connect。  | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 复用活动连接/会话或新建一个，而不是重新连接。                     |
| E\_HC\_NO\_NETWORK                         | 0x89235006 | 当前没有可用的网络连接。                  | [XBOX Live HRESULT 错误代码 (HTTP Client)](/reference/live/xbl-hresult-error-codes#http-client) | 恢复网络连接后重试。                                  |

## 身份验证管理器 (AM)

| 代码                                | 值          | 说明                                          | 来源                                                                                                   | 故障排除                                  |
| --------------------------------- | ---------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------- |
| AM\_E\_XSTS\_UNEXPECTED           | 0x87DD0006 | 已配置 NSAL 目标，但依赖方证书尚未被 XBOX 服务信任。            | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_NOT\_AUTHORIZED            | 0x87DD0009 | 用户无权在当前 TitleId 和 SandboxId 配置下请求 XSTS 令牌。  | [沙盒设置故障排除](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)              | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_UNKNOWN\_TARGET            | 0x87DD000B | 在标题的 NSAL 配置中未找到请求的令牌目标。                    | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_TITLE\_NOT\_AUTHENTICATED  | 0x87DD000D | 标题未针对当前服务配置进行身份验证（例如 TitleId、SCID 或沙盒设置问题）。 | [沙盒设置故障排除](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)              | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_USER\_NOT\_FOUND           | 0x87DD0013 | 用户对象已注销或未知。                                 | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_XSTS\_TIMEOUT              | 0x87DD0019 | 尝试检索 X-token 时达到超时限制。                       | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_NO\_TOKEN\_REQUIRED        | 0x87DD0021 | 请求的终结点不需要令牌，因为它未在 NSAL 中配置为令牌目标。            | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_XTITLE\_TIMEOUT            | 0x87DD0022 | 尝试检索标题令牌时达到超时限制。                            | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |
| AM\_E\_XSTS\_SERVICE\_UNAVAILABLE | 0x87DD0033 | X token 服务不可用。                              | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 验证沙盒、NSAL 目标、TitleId/SCID 配置，并重新获取令牌。 |

## XUser 令牌与签名

| 代码                                         | 值          | 说明                                                       | 来源                                                                                                   | 故障排除                    |
| ------------------------------------------ | ---------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------- |
| WININET\_E\_NAME\_NOT\_RESOLVED            | 0x80072EE7 | 无法解析服务器名称或地址。                                            | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET\_E\_CANNOT\_CONNECT                | 0x80072EFD | 无法与服务器建立连接。                                              | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET\_E\_CONNECTION\_ABORTED            | 0x80072EFE | 与服务器的连接异常终止。                                             | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| WININET\_E\_DECODING\_FAILED               | 0x80072F8F | 内容解码失败。                                                  | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 检查网络/DNS/代理连接，然后重试获取令牌。 |
| XO\_E\_GAME\_USAGE\_BY\_USER\_EXCEEDED     | 0x8015DBFF | 用户已超出允许玩此游戏的时间配额（家长控制）。                                  | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 解决账户/系统策略限制后重试获取令牌。     |
| XO\_E\_SYSTEM\_UPDATE\_REQUIRED            | 0x8015DC01 | 必须先更新系统，才能授予 X-token。                                    | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 解决账户/系统策略限制后重试获取令牌。     |
| XO\_E\_ACCOUNT\_COUNTRY\_NOT\_AUTHORIZED   | 0x8015DC0B | 试图在未获授权的国家/地区使用该标题。                                      | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 解决账户/系统策略限制后重试获取令牌。     |
| XO\_E\_DEVICE\_COUNT\_FOR\_TITLE\_EXCEEDED | 0x8015DC1E | 你已在另一台设备上运行此游戏。请关闭该游戏才能在此处运行。单一存在点 (SPoP / XR-115) 强制执行。 | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 解决账户/系统策略限制后重试获取令牌。     |
| ONL\_E\_FORCESIGNIN                        | 0x80860006 | 为帮助保护账户，用户必须再次登录。                                        | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | 提示用户再次登录后重试请求。          |

## XAL

| 代码                                  | 值          | 说明                    | 来源                                                                          | 故障排除                         |
| ----------------------------------- | ---------- | --------------------- | --------------------------------------------------------------------------- | ---------------------------- |
| E\_XAL\_NOTINITIALIZED              | 0x89235001 | XAL 未初始化。             | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 在使用依赖 XAL 的 API 之前先初始化 XAL。  |
| E\_XAL\_ALREADYINITIALIZED          | 0x89235101 | XAL 已被初始化。            | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 避免在同一生命周期内重复初始化 XAL。         |
| E\_XAL\_USERSETNOTEMPTY             | 0x89235102 | 目标用户集非空。              | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_USERSETFULL                 | 0x89235103 | 用户集已达到其最大容量。          | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_USERSIGNEDOUT               | 0x89235104 | 目标用户已注销。              | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_DUPLICATEDUSER              | 0x89235105 | 用户已存在于用户集中。           | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NETWORK                     | 0x89235106 | 处理请求时发生网络错误。          | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_CLIENTERROR                 | 0x89235107 | XAL 中发生客户端错误。         | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_UIREQUIRED                  | 0x89235108 | 需要用户交互才能完成操作。         | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_HANDLERALREADYREGISTERED    | 0x89235109 | 所需的处理程序已被注册。          | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_UNEXPECTEDUSERSIGNEDIN      | 0x8923510A | 操作过程中登录了不同或意外的用户。     | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NOTATTACHEDTOJVM            | 0x8923510B | 需要时 XAL 未附加到 Java VM。 | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_DEVICEUSER                  | 0x8923510C | 当前设备用户上下文中不允许该操作。     | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_DEFERRALNOTAVAILABLE        | 0x8923510D | 此时无法请求延迟。             | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_MISSINGPLATFORMEVENTHANDLER | 0x8923510E | 缺少所需的平台事件处理程序。        | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_USERNOTFOUND                | 0x8923510F | 找不到指定的用户。             | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NOTOKENREQUIRED             | 0x89235110 | 此请求不需要令牌。             | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_NODEFAULTUSER               | 0x89235111 | 当前没有可用的默认用户。          | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |
| E\_XAL\_FAILEDTORESOLVE             | 0x89235112 | XAL 无法解析请求的特权或身份状态。   | [XBOX Live HRESULT 错误代码 (XAL)](/reference/live/xbl-hresult-error-codes#xal) | 验证 XAL 用户集/会话状态，并按预期的调用顺序重试。 |

## XSAPI

| 代码                                        | 值          | 说明                                                   | 来源                                                                              | 故障排除                                                             |
| ----------------------------------------- | ---------- | ---------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| E\_XBL\_RUNTIME\_ERROR                    | 0x89235200 | 发生了通用的 XBOX Live 运行时错误。                              | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。                                 |
| E\_XBL\_RTA\_GENERIC\_ERROR               | 0x89235201 | 发生了通用实时活动 (RTA) 错误。                                  | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。                                 |
| E\_XBL\_RTA\_SUBSCRIPTION\_LIMIT\_REACHED | 0x89235202 | 已达到 RTA 订阅上限。                                        | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。                                 |
| E\_XBL\_RTA\_ACCESS\_DENIED               | 0x89235203 | 拒绝访问 RTA 功能。                                         | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。                                 |
| E\_XBL\_AUTH\_UNKNOWN\_ERROR              | 0x89235204 | 发生了未知的身份验证错误。                                        | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。                                 |
| E\_XBL\_AUTH\_RUNTIME\_ERROR              | 0x89235205 | 由于运行时错误，身份验证失败。                                      | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。                                 |
| E\_XBL\_AUTH\_NO\_TOKEN                   | 0x89235206 | 没有可用的身份验证令牌。                                         | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 验证 XSAPI 初始化、身份验证令牌可用性以及服务状态后重试。                                 |
| E\_XBL\_ALREADY\_INITIALIZED              | 0x89235207 | XBOX Live 服务已初始化。                                    | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 避免重复调用 XBOX 服务的初始化。                                              |
| E\_XBL\_NOT\_INITIALIZED                  | 0x89235208 | XBOX Live 服务未初始化。                                    | [XBOX Live HRESULT 错误代码 (XSAPI)](/reference/live/xbl-hresult-error-codes#xsapi) | 在调用 XBOX 服务 API 之前先调用 XblInitialize。                             |
| E\_XBL\_RTA\_NOT\_ACTIVATED               | 0x89235209 | 实时活动服务未激活。请调用 XblRealTimeActivityActivate 以激活实时活动服务。 | [错误查找 (xberror.exe)](/tools/tools-console/commandlinetools/xberror)             | 实时活动服务未激活。请调用 XblRealTimeActivityActivate 以激活实时活动服务。(0x89235209) |

## 主机工具与传输

| 代码                                                           | 值          | 说明                       | 来源                                                                     | 故障排除                                                          |
| ------------------------------------------------------------ | ---------- | ------------------------ | ---------------------------------------------------------------------- | ------------------------------------------------------------- |
| E\_APP\_USER\_TERMINATE\_REQUEST                             | 0x87E1001D | 用户明确请求终止应用。              | [错误查找 (xberror.exe)](/tools/tools-console/commandlinetools/xberror)    | 用户明确请求终止应用。(0x87E1001D)                                       |
| E\_DSTORAGE\_XVD\_DEVICE\_NOT\_SUPPORTED                     | 0x89240004 | 指定的 XVD 不在受支持的 NVMe 设备上。 | [错误查找 (xberror.exe)](/tools/tools-console/commandlinetools/xberror)    | 指定的 XVD 不在受支持的 NVMe 设备上。                                      |
| E\_COULD\_NOT\_CONNECT                                       | 0x8C110303 | 无法连接到指定的开发工具包。           | [XTF 传输错误](/tools/tools-console/commandlinetools/xtf-transport-errors) | 无法与目标主机建立连接。请验证指定的 HostName 或 IP 地址。检查防火墙、网络设置以及能否 ping 通该主机。 |
| E\_XTFAPP\_APPLICATION\_EXITED\_BEFORE\_ACTIVATION\_COMPLETE | 0x8D160122 | 应用在完成激活之前退出或崩溃。          | [XTF 传输错误](/tools/tools-console/commandlinetools/xtf-transport-errors) | 无。                                                            |
| E\_XTFAPP\_DIRECTORY\_NOT\_FOUND                             | 0x8D16018D | 未找到提供的目录。                | [XTF 传输错误](/tools/tools-console/commandlinetools/xtf-transport-errors) | 请确保该目录存在。                                                     |

## XBOX PC 远程迭代

| 代码                        | 值          | 说明                                    | 来源                                                       | 故障排除                                                                  |
| ------------------------- | ---------- | ------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------- |
| E\_PROCESSNOTFOUND        | 0x8C114002 | 找不到进程。请验证进程 ID 与活动的目标进程匹配。            | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 通过检查正在运行的进程列表来验证目标进程的进程 ID；提供活动进程的有效进程 ID                             |
| E\_INVALIDPROCESSID       | 0x8C114003 | 进程 ID 无效。请提供数字形式的进程 ID。               | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 提供仅包含数字的有效进程 ID                                                       |
| E\_INVALIDPIN             | 0x8C114004 | PIN 的格式不符合预期。请输入有效的 6 位 PIN。          | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 在客户端设备上输入正确的 PIN                                                      |
| E\_INVALIDSSHKEY          | 0x8C114005 | SSH 密钥格式不符合预期。请使用有效的公钥并重新执行配对。        | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 生成有效的 SSH 公钥；再次执行配对，并提供有效密钥的路径                                        |
| E\_PAIRINGTIMEOUT         | 0x8C114006 | 配对模式超过了最长时间。请重新启动配对并在 2 分钟内输入 PIN。    | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 重新启动 PIN 配对过程；在超时（2 分钟）之前在客户端设备上输入 PIN                                |
| E\_TOOMANYFAILURES        | 0x8C114007 | PIN 尝试失败次数过多。请重新启动配对并输入正确的 PIN。       | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 重新启动 PIN 配对过程；在客户端设备上输入正确的 PIN                                        |
| E\_CLIENTNOTAUTHORIZED    | 0x8C114008 | 设备拒绝了客户端。请成功完成配对，然后重试连接。              | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 成功完成 PIN 配对过程；再次执行连接请求                                                |
| E\_SERVERNOTAUTHORIZED    | 0x8C114009 | 客户端拒绝了设备。请成功完成配对，然后重试连接。              | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 成功完成 PIN 配对过程；再次执行连接请求                                                |
| E\_SSHKEYTOOLARGE         | 0x8C11400A | SSH 密钥过大。请生成受支持类型/大小的密钥并使用该密钥重试。      | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 使用受支持的算法和大小生成新的 SSH 密钥（例如 ED25519 或 RSA-2048）；确保为 RIT 连接指定了正确的密钥      |
| E\_GAMENOTSUSPENDED       | 0x8C11400B | 无法恢复指定的进程。请在调用 resume 之前验证该进程处于挂起状态。  | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 在恢复之前验证进程状态；确保没有其他工具已恢复或终止该进程                                         |
| E\_GAMENOTRUNNING         | 0x8C11400C | 没有正在运行的游戏进程。请在调用游戏进程操作之前启动游戏。         | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 验证当前正在运行的进程；在使用依赖游戏进程的 API 之前启动游戏。                                    |
| E\_GAMEOVERSUSPENDED      | 0x8C11400D | 线程挂起计数不为零。请反复恢复直到挂起计数降为零，或重新启动进程。     | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 反复恢复线程直到挂起计数降为零，或重新启动进程以重置线程状态；也可以重新启动进程以重置线程状态                       |
| E\_GAMESTILLRUNNING       | 0x8C11400E | 一次只能运行一个游戏。请在启动新游戏之前停止当前正在运行的游戏。      | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 确保没有之前的游戏进程在运行；在启动新游戏之前终止当前正在运行的游戏（如有）；重试启动游戏进程                       |
| E\_GAMEEXITABANDONED      | 0x8C11400F | 等待游戏退出的操作已放弃。请验证 PID/TID 并重试终止。       | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 检查游戏进程是否仍在运行；验证是否为终止提供了正确的进程 ID 和线程 ID；重试终止该进程                        |
| E\_GAMEFILEPATHNOTEXIST   | 0x8C114010 | 游戏文件路径不存在。请验证远程路径并确认部署已成功。            | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 验证该路径在远程设备上存在；确认部署已成功                                                 |
| E\_SERVERTOOOLD           | 0x8C114011 | 服务器版本对此客户端过旧。请在远程计算机上更新 `wdEndpoint`。 | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 将远程计算机上的 wdEndpoint 更新到最新版本                                           |
| E\_NAMERESOLUTIONFAILED   | 0x8C114012 | 无法解析远程计算机名。请验证主机名和 DNS，或使用 IP 地址进行测试。 | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 验证主机名拼写、DNS 配置和网络连接；使用 IP 地址隔离名称解析问题。                                 |
| E\_INVALIDADDRESS         | 0x8C114013 | 地址无效。请更正地址格式并使用有效的 IPv4 地址。           | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 确认正确的 IP 地址；更正地址格式并确保使用 IPv4 协议                                       |
| E\_CONNECTIONERROR        | 0x8C114014 | 连接失败。请检查网络/防火墙/服务可用性，然后重试。            | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 检查网络连接、防火墙规则、远程计算机上的服务可用性；检查设备之间的可见性，两台设备应能互相 ping 通；在启用日志记录的情况下重试连接。 |
| E\_LISTENERALREADYRUNNING | 0x8C114015 | 另一个侦听器处于活动状态。请停止现有的终结点实例或复用它。         | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | - 在启动新实例之前停止现有的终结点运行实例；或者，直接复用已在运行的终结点实例，而不是启动新实例                     |
| E\_ADMIN\_REQUIRED        | 0x8C114016 | 需要管理员权限。请以管理员身份运行终结点。                 | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 以管理员身份重新运行终结点                                                         |
| E\_INVALIDTHREADID        | 0x8C114017 | 线程 ID 无效。请提供数字形式的线程 ID。               | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 提供仅包含数字的有效线程 ID                                                       |
| E\_INVALIDPIDTID\_PAIR    | 0x8C114018 | 进程 ID 与线程 ID 不关联。请对该进程重新查询线程并重试。      | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 重新从进程中查询线程列表；确保 ID 未被缓存或过时；验证线程 ID 来自正确的进程上下文。                        |
| E\_THREADNOTFOUND         | 0x8C114019 | 找不到线程。请重新查询当前线程 ID，并使用非过时的 ID 重试。     | [XBOX PC 远程迭代 API 错误代码](/reference/remoting/error-codes) | 重新从进程中查询线程列表；确保 ID 未被缓存或过时；验证线程 ID 来自正确的进程上下文。                        |

## XAPU

| 代码                              | 值          | 说明                               | 来源                                                | 故障排除                             |
| ------------------------------- | ---------- | -------------------------------- | ------------------------------------------------- | -------------------------------- |
| XAPU\_E\_QUEUE\_FULL            | 0x8AC81000 | XAPU 命令队列已满。                     | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | XAPU 命令队列已满。                     |
| XAPU\_E\_PENDING\_RESULTS       | 0x8AC81001 | 当前没有可用的结果。                       | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 当前没有可用的结果。                       |
| XAPU\_E\_INVALID\_COMMAND       | 0x8AC81002 | 无效的 XAPU 命令值。                    | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 无效的 XAPU 命令值。                    |
| XAPU\_E\_INVALID\_STREAM\_INDEX | 0x8AC81003 | 提交的 XAPU 命令中流索引无效。               | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 提交的 XAPU 命令中流索引无效。               |
| XAPU\_E\_NO\_DEVICE\_RESOURCES  | 0x8AC81004 | 系统资源不足以支持所请求的流数量。                | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 系统资源不足以支持所请求的流数量。                |
| XAPU\_E\_ALREADY\_ACTIVE        | 0x8AC81005 | 流已处于活动状态。                        | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 流已处于活动状态。                        |
| XAPU\_E\_BUFFER\_TOO\_SMALL     | 0x8AC81006 | 输出缓冲区太小，无法容纳数据。                  | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 输出缓冲区太小，无法容纳数据。                  |
| XAPU\_E\_PROCESSING\_ERROR      | 0x8AC81007 | 硬件未能处理该命令。                       | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 硬件未能处理该命令。                       |
| XAPU\_E\_BAD\_OPUS\_PACKET      | 0x8AC81008 | 硬件在解码 Opus 数据包时遇到错误。请检查编码是否存在错误。 | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 硬件在解码 Opus 数据包时遇到错误。请检查编码是否存在错误。 |
| XAPU\_E\_DEVICE\_FAULT          | 0x8AC81050 | 发生了不可恢复的固件崩溃。                    | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 发生了不可恢复的固件崩溃。                    |
| XAPU\_E\_DEVICE\_TIMEOUT        | 0x8AC81051 | 硬件未及时响应。                         | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 硬件未及时响应。                         |
| XAPU\_E\_DEVICE\_FATAL\_ERROR   | 0x8AC81052 | 硬件遇到错误，需要重新建立连接。                 | [XAPU 错误](/reference/audio/xapu/enums/xapuerrors) | 硬件遇到错误，需要重新建立连接。                 |

## XDSP

| 代码                                                   | 值          | 说明                                                                                                                             | 来源                                                     | 故障排除                                                                                                                           |
| ---------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| XDSP\_E\_QUEUE\_FULL                                 | 0x8AC810A0 | 命令队列已满。请等待足够的时间让硬件完成对已提交命令的处理，然后再提交更多命令。                                                                                       | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 命令队列已满。请等待足够的时间让硬件完成对已提交命令的处理，然后再提交更多命令。                                                                                       |
| XDSP\_E\_PENDING\_RESULTS                            | 0x8AC810A1 | 在收到所有已提交命令的结果之前，XDspStream 就已停用。请等待足够的时间让硬件完成对流的已提交命令的处理，然后再停用该流。                                                              | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 在收到所有已提交命令的结果之前，XDspStream 就已停用。请等待足够的时间让硬件完成对流的已提交命令的处理，然后再停用该流。                                                              |
| XDSP\_E\_NO\_DEVICE\_RESOURCES                       | 0x8AC810A2 | 没有可用的 XDSP 设备资源来处理你的请求。                                                                                                        | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 没有可用的 XDSP 设备资源来处理你的请求。                                                                                                        |
| XDSP\_E\_DEVICE\_FATAL\_ERROR                        | 0x8AC810A3 | 当前处理的命令发生了致命错误（例如崩溃/挂起）。请查看 [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus) 结构以了解哪个命令序列失败。硬件具有自动恢复机制，允许后续命令继续得到处理。 | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 当前处理的命令发生了致命错误（例如崩溃/挂起）。请查看 [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus) 结构以了解哪个命令序列失败。硬件具有自动恢复机制，允许后续命令继续得到处理。 |
| XDSP\_E\_NOT\_ALL\_HANDLES\_DEACTIVATED              | 0x8AC810A4 | 在与客户端关联的所有 XDspStream 对象停用之前，就对 XDspClient 调用了 [XDspDisconnect](/reference/audio/xdspaudio/functions/xdspdisconnect)。          | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 在与客户端关联的所有 XDspStream 对象停用之前，就对 XDspClient 调用了 [XDspDisconnect](/reference/audio/xdspaudio/functions/xdspdisconnect)。          |
| XDSP\_E\_MAX\_CLIENTS\_EXCEEDED                      | 0x8AC810A5 | 已创建的 XDspClient 数量达到上限。                                                                                                        | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 已创建的 XDspClient 数量达到上限。                                                                                                        |
| XDSP\_E\_MAX\_AGGREGATE\_IMPULSE\_RESPONSE\_EXCEEDED | 0x8AC810A6 | 当前的 [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect) 调用会导致 XDSP 超出所支持的最大聚合脉冲响应长度，因此无效。                          | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 当前的 [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect) 调用会导致 XDSP 超出所支持的最大聚合脉冲响应长度，因此无效。                          |
| XDSP\_E\_INVALID\_IMPULSE\_RESPONSE\_LENGTH          | 0x8AC810A7 | 对 [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate) 的调用使用了过大或过小的脉冲响应长度。                                        | [XDSP 错误](/reference/audio/xdspaudio/enums/xdsperrors) | 对 [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate) 的调用使用了过大或过小的脉冲响应长度。                                        |


## Related topics

- [XBOX Live HRESULT 错误代码](/zh-CN/reference/live/xbl-hresult-error-codes.md)
- [全局 API 方法错误代码](/zh-CN/services/playfab/api-references/global-api-method-error-codes.md)
- [PlayFab Party 错误代码](/zh-CN/services/playfab/multiplayer/networking/reference/partyerrors.md)
- [XBOX PC 远程迭代 API 错误代码](/zh-CN/reference/remoting/error-codes.md)
- [PlayFab 多人游戏 C++ SDK 错误代码](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayererrors.md)
