Skip to main content

XPackageChangeChunkInstallOrder

Especifica qué fragmentos seleccionados se instalarán primero.

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 especifica el tipo de fragmentos que se verán afectados.

Valor devuelto

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

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.
XPackageChangeChunkInstallOrder actualiza los fragmentos seleccionados por el selector especificado para que se coloquen los primeros en la cola de instalación. Puede aceptar un selector, no solo una matriz de identificadores de fragmento. Aquí puede pasar selectores más complejos, y todos los fragmentos que los componen se colocarán al principio de la cola. Puede llamar a XPackageChangeChunkInstallOrder en cualquier momento, no solo cuando los fragmentos no estén instalados. Si los fragmentos ya están instalados, XPackageChangeChunkInstallOrder los ignora. Lo mismo ocurre cuando proporciona fragmentos que, debido a la entrega inteligente, no está programado que se instalen. En el ejemplo siguiente, para que el usuario siga jugando, el juego debe acceder a un archivo llamado “soon”. Se define la función PrioritizeChunk, que comprueba el estado de instalación actual del fragmento. Si el fragmento aún no está instalado, la función pide al sistema de streaming que lo instale y devuelve un monitor de instalación que puede supervisar el progreso del fragmento. Si el fragmento ya está instalado, la función devuelve un monitor nulo.

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