XSystemAllowFullDownloadBandwidth
控制游戏运行时包下载使用的带宽。
语法
void XSystemAllowFullDownloadBandwidth(
bool enable
)
参数
enable _In_
类型：bool
它指示应启用还是禁用完整下载带宽。
返回值
类型：void
备注
注意
在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。
下载包时可使用此 API，以加快下载速度。 在参数设置为 true 的情况下进行调用时，API 会指示系统操作系统使用更多资源进行下载。 下载完成后，必须在参数设置为 false 的情况下再次调用 API，以便向系统操作系统发出信号，表明资源可以回收。
开发人员使用此 API 时应注意的方面：
- 此 API 将更改系统操作系统中的 CPU 性能。 如果游戏尝试执行大量跨 VM 操作（存储操作、空间音频等），性能可能会降低。 因此，此功能不得在游戏的整个生存期都保持启用状态。
注意
此 API 只向系统 OS 发送一个信号，如果系统 OS 需要这些资源执行其他操作，则系统 OS 可以选择忽略它。
潜在使用示例：如果游戏正在开始为 DLC 或其他基础游戏下载内容，并且游戏提供进度栏，那么该游戏可能会考虑在玩家位于该屏幕上时（而非正在玩游戏时）调用此 API。 如果玩家切换到其他视图，游戏应禁用此功能，确保游戏完全控制自己的网络带宽。
void AllowFullDownloadBandwidth()
{
XSystemAllowFullDownloadBandwidth(true);
// Kick off download of DLC or related package
// Download complete or enter more active gameplay
XSystemAllowFullDownloadBandwidth(false);
}
要求
头文件：XSystem.h
库：xgameruntime.lib
支持的平台：Xbox Series 主机