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
Last modified on October 6, 2026