> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackageChangeChunkInstallOrder

> XPackageChangeChunkInstallOrder

# XPackageChangeChunkInstallOrder

Especifica qué fragmentos seleccionados se instalarán primero.

## Sintaxis

```cpp theme={null}
HRESULT XPackageChangeChunkInstallOrder(  
        const char* packageIdentifier,  
        uint32_t selectorCount,  
        XPackageChunkSelector* selectors
)  
```

### 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)](/publishing/xstore-commerce/xstore-dlc).

*selectorCount*   \_In\_\
Tipo: uint32\_t

El número de selectores del parámetro *selectors*.

*selectors*   \_In\_reads\_(selectorCount)\
Tipo: [XPackageChunkSelector\*](/reference/system/xpackage/structs/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

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

**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.

```cpp theme={null}
HRESULT PrioritizeChunk( 
    XTaskQueueHandle queue, uint32_t chunkId, XPackageInstallationMonitorHandle* monitor) 
{ 
    char id[XPACKAGE_IDENTIFIER_MAX_LENGTH]; 
 
    *monitor = nullptr; 
    HRESULT hr = XPackageGetCurrentProcessPackageIdentifier(_countof(id), id); 
    if (FAILED(hr)) return hr; 
 
    XPackageChunkSelector selector; 
    selector.type = XPackageChunkSelectorType::Chunk; 
    selector.chunkId = chunkId; 
 
    hr = XPackageCreateInstallationMonitor(id, 1, &selector, 1000, queue, monitor); 
 
    if (SUCCEEDED(hr)) 
    { 
        XPackageInstallationProgress progress; 
        XPackageGetInstallationProgress(*monitor, &progress); 
    }

    if (!progress.completed) 
    { 
        hr = XPackageChangeChunkInstallOrder(id, 1, &selector); 
    } 
 
    if (progress.completed || FAILED(hr)) 
    { 
        XPackageCloseInstallationMonitorHandle(*monitor); 
        *monitor = nullptr; 
    } 
 
    return hr; 
} 
```

## Requisitos

**Encabezado:** XPackage.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[XPackage](/reference/system/xpackage/xpackage_members)\
[Instalación de streaming y entrega inteligente](/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)


## Related topics

- [XPackage](/es/reference/system/xpackage/xpackage_members.md)
- [XPackageInstallChunks](/es/reference/system/xpackage/functions/xpackageinstallchunks.md)
- [XPackageInstallChunksAsync](/es/reference/system/xpackage/functions/xpackageinstallchunksasync.md)
- [XPackageInstallChunksResult](/es/reference/system/xpackage/functions/xpackageinstallchunksresult.md)
- [XR-129 Administración de contenido de entrega inteligente](/es/publishing/certification/xr/xr-129.md)