> ## 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

Spécifie quels blocs sélectionnés doivent être installés en premier.

## Syntaxe

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

### Paramètres

*packageIdentifier*   \_In\_z\_\
Type : char\*

Chaîne qui identifie de manière unique le package installé sur le disque.  Pour plus d'informations sur les identificateurs de package, consultez [Gérer et accorder des licences pour le contenu téléchargeable (DLC)](/fr/publishing/xstore-commerce/xstore-dlc).

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

Nombre de sélecteurs dans le paramètre *selectors*.

*selectors*   \_In\_reads\_(selectorCount)\
Type : [XPackageChunkSelector\*](/fr/reference/system/xpackage/structs/xpackagechunkselector)

Tableau de sélecteurs qui spécifie le type de blocs concernés.

### Valeur renvoyée

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

<Note>Cette fonction ne peut pas être appelée en toute sécurité sur un thread à contrainte de temps. Pour plus d'informations, consultez [Threads à contrainte de temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

**XPackageChangeChunkInstallOrder** place les blocs sélectionnés par le sélecteur spécifié en tête de la file d'attente d'installation. Cette fonction accepte un sélecteur, et pas seulement un tableau d'ID de blocs. Vous pouvez transmettre ici des sélecteurs plus complexes, et les blocs qui les composent seront tous placés en tête de la file d'attente.

Vous pouvez appeler **XPackageChangeChunkInstallOrder** à tout moment, et pas uniquement lorsque les blocs ne sont pas installés. Si les blocs sont déjà installés, **XPackageChangeChunkInstallOrder** les ignore. Il en va de même lorsque vous fournissez des blocs qui, en raison d'Intelligent Delivery, ne sont pas du tout prévus pour être installés.

Dans l'exemple suivant, pour que l'utilisateur puisse continuer à jouer, le jeu doit accéder à un fichier appelé « soon ». La fonction PrioritizeChunk est définie et vérifie l'état d'installation actuel du bloc. Si le bloc n'est pas encore installé, la fonction demande au système de streaming de l'installer et renvoie un moniteur d'installation capable de surveiller la progression du bloc. Si le bloc est déjà installé, la fonction renvoie un moniteur null.

```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; 
} 
```

## Configuration requise

**En-tête :** XPackage.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Threads à contrainte de temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XPackage](/fr/reference/system/xpackage/xpackage_members)\
[Installation en streaming et Intelligent Delivery](/fr/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)


## Related topics

- [XPackageChangeChunkInstallOrder](/ja-jp/reference/system/xpackage/functions/xpackagechangechunkinstallorder.md)
- [XPackage](/reference/system/xpackage/xpackage_members.md)
- [Dynamic reordering of chunks](/build/core-features/common/packaging/packaging-chunkreordering.md)