Skip to main content

XPackageEstimateDownloadSize

Calcula o tamanho do download das partes que correspondem aos seletores de instalação especificados.

Sintaxe

Parâmetros

packageIdentifier   _In_z_
Tipo: char*
Uma cadeia de caracteres que identifica exclusivamente o pacote instalado no disco. Para obter mais informações sobre identificadores de pacote, consulte Gerenciar e licenciar conteúdo para download (DLC). selectorCount   _In_
Tipo: uint32_t
O número de seletores no parâmetro selectors. selectors   _In_reads_(selectorCount)
Tipo: XPackageChunkSelector*
Uma matriz de seletores que especificam as partes nas quais operar. downloadSize   _Out_
Tipo: uint64_t*
No retorno, contém o tamanho do download dos seletores de instalação especificados. shouldPresentUserConfirmation   _Out_opt_
Tipo: bool*
Se o download exigir a confirmação do usuário, retorna true; caso contrário, retorna false.

Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT.

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.
Se fornecido, o parâmetro shouldPresentUserConfirmation será definido como true se o tamanho estimado do download for grande o suficiente para solicitar que o usuário aceite o tamanho do download. O exemplo a seguir aceita um nome de pista de um jogo de corrida e, se a pista não estiver instalada, imprime o tamanho do download da pista:

Requisitos

Cabeçalho: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XPackage
Instalação por streaming e Intelligent Delivery
Last modified on October 6, 2026