> ## 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](/zh-TW/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystemAllowFullDownloadBandwidth](/reference/system/xsystem/functions/xsystemallowfulldownloadbandwidth.md)
- [XSystem](/reference/system/xsystem/xsystem_members.md)