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.
- 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.
Requisitos
Encabezado: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
- Entrega inteligente: especificadores de etiqueta personalizados
- Entrega inteligente: características y recetas
- Entrega inteligente: especificadores de idioma
- Entrega inteligente: contenido a petición (OnDemand)
- Subprocesos sensibles al tiempo
