Skip to main content

XSystemAllowFullDownloadBandwidth

ゲームの実行中に、パッケージのダウンロードで使用される帯域幅を制御します。

Syntax

Parameters

enable    _In_
型: bool
フル ダウンロード帯域幅を有効にするか無効にするかを指定します。

Return value

型: void

Remarks

この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
この API は、パッケージのダウンロードを高速化するために使用できます。パラメーターを true に設定して呼び出すと、より多くのリソースをダウンロードに使用するようシステム OS にシグナルを送信します。ダウンロードが完了した後は、リソースを回収できることをシステム OS にシグナルするため、パラメーターを false に設定してこの API を再度呼び出す必要があります。 この API を使用する際に開発者が把握しておくべき事項:
  • この API はシステム OS における CPU パフォーマンスを変更します。タイトルが重い VM 間操作 (ストア操作、空間オーディオなど) を行おうとすると、パフォーマンスの低下が発生する可能性があります。そのため、この機能をゲームの実行全体で有効にしたままにするべきではありません。
この API はシステム OS へのシグナルを送信するだけであり、システム OS が他の操作にリソースを必要とする場合はこれを無視することもあります。
使用例: DLC や別のベース ゲームのダウンロードを開始する場合、ゲームが進行状況バーを提供しているなら、プレイヤーがその画面にいてアクティブなゲームプレイ中でないタイミングでこの API を呼び出すことを検討できます。プレイヤーが別のビューに切り替わった場合、ゲームは自身のネットワーク帯域幅を完全に制御できるように、これを無効にする必要があります。

Requirements

ヘッダー: XSystem.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: XBOX Series 本体

Conceptual documentation

See also

XSystem
最終更新日 2026年8月24日