Skip to main content

XSystemAllowFullDownloadBandwidth

게임이 실행되는 동안 패키지 다운로드에 사용되는 대역폭을 제어합니다.

구문

매개 변수

enable    _In_
형식: bool
전체 다운로드 대역폭을 사용 설정할지 아니면 사용하지 않도록 설정할지를 나타냅니다.

반환 값

형식: void

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
이 API는 패키지를 다운로드할 때 다운로드 속도를 높이기 위해 사용할 수 있습니다. 매개 변수를 true로 설정하여 호출하면 API는 시스템 OS에 더 많은 리소스를 다운로드에 사용하도록 신호를 보냅니다. 다운로드가 완료되면 시스템 OS가 리소스를 회수할 수 있도록 매개 변수를 false로 설정하여 API를 다시 호출해야 합니다. 이 API를 사용할 때 개발자가 알아야 할 사항:
  • 이 API는 시스템 OS의 CPU 성능을 변경합니다. 타이틀이 대규모의 VM 간 작업(스토어 작업, 공간 오디오 등)을 시도하는 경우 성능 저하를 경험할 수 있습니다. 따라서 이 기능을 게임의 전체 수명 동안 켜 놓아서는 안 됩니다.
이 API는 시스템 OS에 신호만 보내며, 시스템 OS가 다른 작업을 위해 해당 리소스가 필요한 경우 무시할 수도 있습니다.
잠재적인 사용 예: 게임이 DLC 또는 다른 기본 게임의 다운로드를 시작하고 게임에서 진행률 표시줄을 제공하는 경우, 게이머가 해당 화면에 있고 실제 게임 플레이가 아닐 때 이 API 호출을 고려할 수 있습니다. 게이머가 다른 뷰로 전환하면 게임이 자체 네트워크 대역폭을 완전히 제어할 수 있도록 이 기능을 비활성화해야 합니다.

요구 사항

헤더: XSystem.h 라이브러리: xgameruntime.lib 지원 플랫폼: XBOX Series 콘솔

개념 문서

함께 보기

XSystem
마지막 수정일 2026년 8월 24일