Skip to main content

​
XSystemAllowFullDownloadBandwidth

Controla a largura de banda usada por um download de pacote enquanto o jogo está em execução.

​
Sintaxe

​
Parâmetros

enable    _In_
Tipo: bool Indica se a largura de banda total de download deve ser habilitada ou desabilitada.

​
Valor retornado

Tipo: void

​
Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Essa API pode ser usada ao baixar um pacote para acelerar o download. Quando chamada com o parâmetro definido como true, a API sinaliza ao sistema operacional do sistema para usar mais recursos para o download. A API deve ser chamada novamente com o parâmetro definido como false quando o download for concluído, para sinalizar de volta ao sistema operacional do sistema que os recursos podem ser recuperados. Aspectos dos quais os desenvolvedores devem estar cientes ao usar essa API:
  • Essa API alterará o desempenho da CPU no sistema operacional do sistema. Se o título estiver tentando realizar operações pesadas entre VMs (operações da loja, áudio espacial etc.), poderá ocorrer degradação do desempenho. Portanto, esse recurso não deve ficar habilitado durante todo o tempo de vida do jogo.
Essa API apenas envia um sinal ao sistema operacional do sistema, e o sistema operacional do sistema pode optar por ignorá-lo se precisar desses recursos para outras operações.
Exemplo de uso potencial: Se o jogo estiver iniciando o download de um DLC ou de outro jogo base e estiver exibindo uma barra de progresso, o jogo poderá considerar chamar essa API enquanto o jogador estiver nessa tela e não em jogabilidade ativa. Se o jogador mudar para uma exibição diferente, o jogo deverá desabilitar esse recurso para garantir que tenha controle total da própria largura de banda de rede.

​
Requisitos

Cabeçalho: XSystem.h Biblioteca: xgameruntime.lib Plataformas com suporte: consoles XBOX Series

​
Documentação conceitual

​
Confira também

XSystem
Last modified on October 6, 2026