Skip to main content

XPackageInstallChunks

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. queue   _In_opt_
Tipo: XTaskQueueHandle
A fila assíncrona na qual o trabalho será executado. installationMonitor   _Out_
Tipo: XPackageInstallationMonitorHandle*
No retorno, contém um identificador para um monitor de instalação que monitorará a instalação das partes que correspondem ao seletor.

Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT.
Retorna um erro de cancelamento se a instalação for rejeitada.

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.
A instalação de partes pode envolver solicitar que o usuário aceite o tamanho do download.
  • Se você usar a versão síncrona desta API, ela ficará bloqueada até que o usuário aceite ou recuse o download. Se o usuário recusar, a chamada falhará com o erro de cancelamento E_ABORT. Ela retornará um monitor de instalação que você pode usar para monitorar o status da instalação. O monitor deve ser fechado em algum momento, chamando XPackageCloseInstallationMonitorHandle.
  • Definir suppressUserConfirmation como true permitirá que você forneça uma interface do usuário personalizada que solicitará o download ao usuário.
Este exemplo instalará as partes que correspondem à marca “BigMaps”:

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