Skip to main content

XPackageInstallChunks

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. queue   _In_opt_
Tipo: XTaskQueueHandle
La cola asincrónica en la que se realizará el trabajo. installationMonitor   _Out_
Tipo: XPackageInstallationMonitorHandle*
Al devolverse, contiene un identificador de un monitor de instalación que supervisará la instalación de los fragmentos que coincidan con el selector.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error.
Devuelve un error de cancelación si se rechaza la instalación.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
La instalación de fragmentos podría implicar pedir al usuario que acepte el tamaño de la descarga.
  • Si usa la versión sincrónica de esta API, se bloqueará hasta que el usuario acepte o rechace la descarga. Si el usuario la rechaza, la llamada dará error con el error de cancelación E_ABORT. Esto devolverá un monitor de instalación que puede usar para supervisar el estado de la instalación. En algún momento se debe cerrar el monitor, llamando a XPackageCloseInstallationMonitorHandle.
  • Establecer suppressUserConfirmation en true le permitirá proporcionar una interfaz de usuario personalizada que pedirá al usuario que confirme la descarga.
Este ejemplo instalará los fragmentos que corresponden a la etiqueta “BigMaps”:

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