XSystemAllowFullDownloadBandwidth
게임이 실행되는 동안 패키지 다운로드에서 사용하는 대역폭을 제어합니다.
구문
void XSystemAllowFullDownloadBandwidth(
bool enable
)
매개 변수
enable _In_
형식: bool
전체 다운로드 대역폭을 사용하도록 설정하거나 사용하지 않도록 설정해야 하는지 여부를 알려줍니다.
반환 값
형식: void
비고
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
이 API는 다운로드 속도를 높이기 위해 패키지를 다운로드할 때 사용할 수 있습니다. 매개 변수를 true로 설정하여 호출하면 API는 시스템 OS에 다운로드에 더 많은 리소스를 사용하라는 신호를 보냅니다. 리소스를 회수할 수 있다는 신호를 시스템 OS에 다시 전달하려면 다운로드가 완료되면 매개 변수를 false 로 설정하여 API를 다시 호출해야 합니다.
개발자가 이 API를 사용할 때 알아야 할 측면은 다음과 같습니다.
- 이 API는 시스템 OS의 CPU 성능을 변경합니다. 타이틀이 과도한 VM 간 작업(저장소 작업, 공간 오디오 등)을 수행하려고 하면 성능이 저하될 수 있습니다. 따라서 이 기능은 게임의 전체 수명을 사용하도록 설정해서는 안 됩니다.
참고 항목
이 API는 시스템 OS에 신호만 보내고 시스템 OS는 다른 작업에 해당 리소스가 필요한 경우 이를 무시하도록 선택할 수 있습니다.
잠재적 사용 예: 게임이 DLC 또는 다른 기본 게임에 대한 다운로드를 시작하고 게임이 진행률 표시줄을 제공하는 경우 게임에서는 게이머가 활성 게임 플레이가 아닌 해당 화면에 있는 동안 이 API를 호출하는 것을 고려할 수 있습니다. 게이머가 다른 보기로 전환하면 게임에서 이를 사용하지 않도록 설정하여 게임이 자체 네트워크 대역폭을 완전히 제어할 수 있도록 해야 합니다.
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 콘솔