Skip to main content

XPackageChangeChunkInstallOrder

Especifica quais partes selecionadas devem ser instaladas primeiro.

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 especifica o tipo de partes a serem afetadas.

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.
XPackageChangeChunkInstallOrder atualiza as partes selecionadas pelo seletor especificado para que sejam colocadas no início da fila de instalação. Ela pode receber um seletor, não apenas uma matriz de IDs de parte. Você pode passar seletores mais complexos aqui, e todas as partes que os compõem serão enviadas para o início da fila. Você pode chamar XPackageChangeChunkInstallOrder a qualquer momento, não apenas quando as partes não estão instaladas. Se as partes já estiverem instaladas, XPackageChangeChunkInstallOrder as ignora. O mesmo vale quando você fornece partes que, devido à entrega inteligente, não estão agendadas para serem instaladas. No exemplo a seguir, para manter o usuário jogando, o jogo precisa acessar um arquivo chamado “soon”. A função PrioritizeChunk é definida e verifica o status de instalação atual da parte. Se a parte ainda não estiver instalada, a função solicita ao sistema de streaming que a instale e retorna um monitor de instalação que pode monitorar o progresso da parte. Se a parte já estiver instalada, a função retorna um monitor nulo.

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