Skip to main content

XPackageInstallChunksAsync

Inicia la instalación de fragmentos.

Sintaxis

Parámetros

packageIdentifier   _In_z_
Tipo: char*
Una cadena que identifica de forma única el paquete instalado en el disco. Para obtener más información sobre los identificadores de paquete, consulte Administración y concesión de licencias de contenido descargable (DLC). selectorCount   _In_
Tipo: uint32_t
El número de selectores del parámetro selectors. selectors   _In_reads_(selectorCount)
Tipo: XPackageChunkSelector*
Una matriz de selectores que especifican los fragmentos que se van a instalar. minimumUpdateIntervalMs   _In_
Tipo: uint32_t
El intervalo entre actualizaciones, en milisegundos. suppressUserConfirmation   _In_
Tipo: bool
Si los fragmentos que se van a instalar superan un tamaño preestablecido, se mostrará un mensaje de confirmación. Si suppressUserConfirmation es true, no se mostrará ningún mensaje y la instalación progresará como si el usuario hubiera aceptado. Esto permite que el juego presente su propia interfaz de usuario. Si el juego usa esta opción, también debe llamar a XPackageEstimateDownloadSize para obtener el tamaño que se presentará al usuario. XPackageEstimateDownloadSize también devuelve un valor booleano, para indicar si el tamaño es lo suficientemente grande como para que se deba mostrar un mensaje. Si se necesita una confirmación de descarga, el juego debe mostrarla mediante su propia interfaz de usuario o dejar que XPackageInstallChunks la muestre. asyncBlock   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock para supervisar el estado de la llamada asincrónica.

Valor devuelto

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

Comentarios

XPackageInstallChunks tiene una variante asincrónica. La instalación de fragmentos podría implicar pedir al usuario que acepte el tamaño de la descarga. En este ejemplo se muestra cómo se instalan los BigMaps mediante las API asincrónicas:

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
Instalación por streaming y entrega inteligente
XPackageInstallChunks
Última modificación el 28 de agosto de 2026