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

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

## Syntax

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

### Parameters

*enable*    \_In\_\
型: bool

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

### Return value

型: void

## Remarks

<Note>この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、[タイム センシティブ スレッド](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) を参照してください。</Note>

この API は、パッケージのダウンロードを高速化するために使用できます。パラメーターを *true* に設定して呼び出すと、より多くのリソースをダウンロードに使用するようシステム OS にシグナルを送信します。ダウンロードが完了した後は、リソースを回収できることをシステム OS にシグナルするため、パラメーターを *false* に設定してこの API を再度呼び出す必要があります。

この 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);
} 
```

## Requirements

**ヘッダー:** XSystem.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** XBOX Series 本体

## Conceptual documentation

* [タイム センシティブ スレッド](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

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


## Related topics

- [XSystem](/ja-jp/reference/system/xsystem/xsystem_members.md)
- [XBOX 認定の概要](/ja-jp/publishing/certification/overview.md)
- [XPackageEstimateDownloadSize](/ja-jp/reference/system/xpackage/functions/xpackageestimatedownloadsize.md)
- [XStoreDownloadAndInstallPackagesAsync](/ja-jp/reference/system/xstore/functions/xstoredownloadandinstallpackagesasync.md)
- [XStoreDownloadAndInstallPackagesResult](/ja-jp/reference/system/xstore/functions/xstoredownloadandinstallpackagesresult.md)