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.
- 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.
Requisitos
Cabeçalho: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
- Intelligent Delivery: especificadores de marca personalizados
- Intelligent Delivery: recursos e receitas
- Intelligent Delivery: especificadores de idioma
- Intelligent Delivery: conteúdo OnDemand
- Threads sensíveis ao tempo
