Skip to main content

XPackageRegisterPackageInstalled

Registra una devolución de llamada a la que se llamará cuando se complete una instalación.

Sintaxis

Parámetros

queue   _In_
Tipo: XTaskQueueHandle
La cola asincrónica en la que se ejecutará la devolución de llamada. context   _In_opt_
Tipo: void*
Contexto que se pasará a la devolución de llamada. callback   _In_
Tipo: XPackageInstalledCallback*
Devolución de llamada definida por el usuario a la que se llamará cuando se complete una instalación. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Al devolverse, contiene un token que identifica la devolución de llamada y que se puede usar para anular su registro con XPackageUnregisterPackageInstalled.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error.

Comentarios

Las notificaciones de PackageInstalled se pueden usar para determinar cuándo un paquete nuevo está completamente instalado. Tanto la API XPackageEnumeratePackages como la API XPackageRegisterPackageInstalled proporcionan detalles sobre una instalación, a través de una estructura XPackageDetails. Si el paquete se está instalando, la propiedad installing se establece en true y puede crear un monitor de instalación, para que el identificador del paquete supervise el progreso de la instalación. No hay notificaciones genéricas de cola de instalación; la intención es usar XPackageEnumeratePackages para mostrar y hacer seguimiento de los elementos en curso, y usar PackageInstalled para anunciar la presencia de nuevo DLC. Tampoco hay una API para detener, iniciar o cancelar una instalación. Desde la perspectiva de un juego, la instalación debería gestionarse por sí sola. Los errores se reintentan automáticamente y son invisibles para el juego. En el siguiente ejemplo, XPackageRegisterPackageInstalled se usa para imprimir un mensaje cuando se instala un nuevo paquete de DLC:

Requisitos

Encabezado: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XPackage
Última modificación el 28 de agosto de 2026