Skip to main content

XPackageRegisterPackageInstalled

Registra um retorno de chamada a ser chamado quando uma instalação for concluída.

Sintaxe

Parâmetros

queue   _In_
Tipo: XTaskQueueHandle
A fila assíncrona na qual o retorno de chamada deve ser executado. context   _In_opt_
Tipo: void*
Contexto a ser passado para o retorno de chamada. callback   _In_
Tipo: XPackageInstalledCallback*
Retorno de chamada definido pelo usuário a ser chamado quando uma instalação for concluída. token   _Out_
Tipo: XTaskQueueRegistrationToken*
No retorno, contém um token que identifica o retorno de chamada e que pode ser usado para cancelar o registro do retorno de chamada com XPackageUnregisterPackageInstalled.

Valor retornado

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

Comentários

As notificações PackageInstalled podem ser usadas para determinar quando um novo pacote está totalmente instalado. Tanto a API XPackageEnumeratePackages quanto a API XPackageRegisterPackageInstalled fornecem detalhes sobre uma instalação por meio de uma estrutura XPackageDetails. Se o pacote estiver sendo instalado, a propriedade installing será definida como true e você poderá criar um monitor de instalação para que o identificador do pacote monitore o progresso da instalação. Não há notificações genéricas de fila de instalação; a intenção é usar XPackageEnumeratePackages para mostrar e acompanhar itens em andamento e usar PackageInstalled para anunciar a presença de um novo DLC. Também não há uma API para parar, iniciar ou cancelar uma instalação. Da perspectiva de um jogo, a instalação deve cuidar de si mesma. Os erros são repetidos automaticamente e ficam invisíveis para o jogo. No exemplo a seguir, XPackageRegisterPackageInstalled é usado para imprimir uma mensagem quando um novo pacote de DLC é instalado:

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