> ## 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에 더 많은 리소스를 다운로드에 사용하도록 신호를 보냅니다. 다운로드가 완료되면 시스템 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);
} 
```

## 요구 사항

**헤더:** 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](/ko/reference/system/xsystem/xsystem_members.md)
- [XBOX 인증 개요](/ko/publishing/certification/overview.md)
- [XPackageEstimateDownloadSize](/ko/reference/system/xpackage/functions/xpackageestimatedownloadsize.md)
- [XStoreDownloadPackageUpdatesAsync](/ko/reference/system/xstore/functions/xstoredownloadpackageupdatesasync.md)
- [XStoreDownloadPackageUpdatesResult](/ko/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)