Skip to main content

XSystemAllowFullDownloadBandwidth

控制游戏运行时包下载所用的带宽。

语法

参数

enable    _In_
类型:bool
指示是否应启用或禁用完整下载带宽。

返回值

类型:void

备注

在时间敏感型线程上调用此函数不安全。有关详细信息,请参阅时间敏感型线程
下载包时可以使用此 API 来加快下载速度。当以参数设置为 true 调用时,此 API 向系统 OS 发出信号,让其使用更多资源进行下载。下载完成后,必须再次以参数设置为 false 调用该 API,以便向系统 OS 发送信号,表示可以回收这些资源。 开发人员在使用此 API 时应了解以下方面:
  • 此 API 将更改系统 OS 中的 CPU 性能。如果游戏正在尝试执行大量跨 VM 操作(商店操作、空间音频等),可能会遇到性能下降。因此,此功能不应在游戏的整个生命周期内保持启用。
此 API 仅向系统 OS 发送信号,如果系统 OS 需要这些资源用于其他操作,它可以选择忽略该信号。
可能的使用示例: 如果游戏正在开始下载 DLC 或其他基础游戏,并且游戏正在提供进度条,则游戏可能会考虑在玩家处于该屏幕而非活跃游戏时调用此 API。如果玩家切换到其他视图,游戏应禁用此项以确保游戏完全控制其自己的网络带宽。

要求

头文件: XSystem.h 库: xgameruntime.lib 支持的平台: XBOX Series 主机

概念文档

另请参阅

XSystem
最后修改于 2026年8月24日