> ## 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 les blocs sélectionnés à installer 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 façon unique le package installé sur le disque.  Pour plus d'informations sur les identificateurs de package, consultez [Gérer le contenu téléchargeable (DLC) et ses licences](/fr-CA/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-CA/reference/system/xpackage/structs/xpackagechunkselector)

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

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread sensible au temps. Pour plus d'informations, consultez [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

**XPackageChangeChunkInstallOrder** met à jour les blocs sélectionnés par le sélecteur spécifié afin qu'ils soient placés en premier dans la file d'attente d'installation. Cette fonction peut accepter un sélecteur, et pas seulement un tableau d'ID de blocs. Vous pouvez passer 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 seulement 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 déjà installé, la fonction demande au système de diffusion en continu de l'installer et retourne un moniteur d'installation qui peut suivre la progression du bloc. Si le bloc est déjà installé, la fonction retourne 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 sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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


## Related topics

- [XPackage](/fr-CA/reference/system/xpackage/xpackage_members.md)
- [XPackageInstallChunks](/fr-CA/reference/system/xpackage/functions/xpackageinstallchunks.md)
- [XPackageInstallChunksAsync](/fr-CA/reference/system/xpackage/functions/xpackageinstallchunksasync.md)
- [XPackageInstallChunksResult](/fr-CA/reference/system/xpackage/functions/xpackageinstallchunksresult.md)
- [Intelligent Delivery : spécificateurs de balises personnalisées](/fr-CA/build/core-features/common/packaging/intelligentdelivery-custom.md)