Skip to main content

XPackageInstallChunksAsync

Inicia a instalação de partes.

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 baixável (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 a serem instaladas. minimumUpdateIntervalMs   _In_
Tipo: uint32_t
O intervalo entre atualizações, em milissegundos. suppressUserConfirmation   _In_
Tipo: bool
Se as partes a serem instaladas excederem um tamanho predefinido, um prompt de confirmação será exibido. Se suppressUserConfirmation for true, nenhum prompt será exibido e a instalação prosseguirá como se o usuário tivesse aceitado. Isso permite que o jogo apresente sua própria interface do usuário. Se o jogo usar esse recurso, ele também deverá chamar XPackageEstimateDownloadSize para obter o tamanho que será apresentado ao usuário. XPackageEstimateDownloadSize também retorna um booliano para indicar se o tamanho é grande o suficiente para que um prompt seja exibido. Se for necessária uma confirmação de download, o jogo deverá exibi-la usando sua própria interface do usuário ou permitir que XPackageInstallChunks a exiba. asyncBlock   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock para monitorar o status da chamada assíncrona.

Valor retornado

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

Comentários

XPackageInstallChunks tem uma variante assíncrona. A instalação de partes pode envolver solicitar que o usuário aceite o tamanho do download. Este exemplo mostra como os BigMaps são instalados usando as APIs assíncronas:

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
XPackageInstallChunks
Last modified on October 6, 2026