Skip to main content

XPackageFindChunkAvailability

Retorna a disponibilidade mínima para a coleção de partes que correspondem aos seletores 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_opt_(selectorCount)
Tipo: XPackageChunkSelector*
Uma matriz de seletores que especificam as partes a serem verificadas. availability   _Out_
Tipo: XPackageChunkAvailability*
No retorno, lista a disponibilidade das partes.

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.
XPackageFindChunkAvailability recebe uma matriz de seletores de parte, localiza as partes associadas e, em seguida, retorna a disponibilidade mínima dessas partes. A disponibilidade varia de acordo com os seguintes valores:
  • Ready: a parte já está instalada e pode ser lida.
  • Pending: a parte ainda não está instalada, mas será.
  • Installable: a parte não será instalada, mas pode ser baixada.
  • Unavailable: a parte não pode ser baixada.
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