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

# XSystemAllowFullDownloadBandwidth

> XSystemAllowFullDownloadBandwidth

# XSystemAllowFullDownloadBandwidth

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

## 语法

```cpp theme={null}
void XSystemAllowFullDownloadBandwidth(  
    bool enable
)  
```

### 参数

*enable*    \_In\_\
类型：bool

指示是否应启用或禁用完整下载带宽。

### 返回值

类型：void

## 备注

<Note>在时间敏感型线程上调用此函数不安全。有关详细信息，请参阅[时间敏感型线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

下载包时可以使用此 API 来加快下载速度。当以参数设置为 *true* 调用时，此 API 向系统 OS 发出信号，让其使用更多资源进行下载。下载完成后，必须再次以参数设置为 *false* 调用该 API，以便向系统 OS 发送信号，表示可以回收这些资源。

开发人员在使用此 API 时应了解以下方面：

* 此 API 将更改系统 OS 中的 CPU 性能。如果游戏正在尝试执行大量跨 VM 操作（商店操作、空间音频等），可能会遇到性能下降。因此，此功能不应在游戏的整个生命周期内保持启用。

<Note>此 API 仅向系统 OS 发送信号，如果系统 OS 需要这些资源用于其他操作，它可以选择忽略该信号。</Note>

可能的使用示例：
如果游戏正在开始下载 DLC 或其他基础游戏，并且游戏正在提供进度条，则游戏可能会考虑在玩家处于该屏幕而非活跃游戏时调用此 API。如果玩家切换到其他视图，游戏应禁用此项以确保游戏完全控制其自己的网络带宽。

```cpp theme={null}
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 主机

## 概念文档

* [时间敏感型线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另请参阅

[XSystem](/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystem](/zh-CN/reference/system/xsystem/xsystem_members.md)
- [XPackageEstimateDownloadSize](/zh-CN/reference/system/xpackage/functions/xpackageestimatedownloadsize.md)
- [XStoreDownloadAndInstallPackagesAsync](/zh-CN/reference/system/xstore/functions/xstoredownloadandinstallpackagesasync.md)
- [XStoreDownloadAndInstallPackagesResult](/zh-CN/reference/system/xstore/functions/xstoredownloadandinstallpackagesresult.md)
- [XStoreDownloadPackageUpdatesAsync](/zh-CN/reference/system/xstore/functions/xstoredownloadpackageupdatesasync.md)