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

# XPackageCloseInstallationMonitorHandle

> XPackageCloseInstallationMonitorHandle

# XPackageCloseInstallationMonitorHandle

Ferme un moniteur d'installation spécifié qui a été ouvert précédemment.

## Syntaxe

```cpp theme={null}
void XPackageCloseInstallationMonitorHandle(  
         XPackageInstallationMonitorHandle installationMonitor  
)  
```

### Paramètres

*installationMonitor*   \_In\_\
Type : XPackageInstallationMonitorHandle

Handle du moniteur d'installation à fermer.

### Valeur de retour

Type : void

## Remarques

Tout moniteur d'installation que vous utilisez pour surveiller l'état de l'installation doit éventuellement être fermé en appelant **XPackageCloseInstallationMonitorHandle**.

Un jeu a implémenté un marqueur de lancement, de sorte qu'il peut être exécuté avant d'être complètement installé. Le jeu devra savoir quelles parties sont installées et lesquelles ne le sont pas. Dans cet exemple, le jeu doit savoir quand les blocs associés à une piste de course portant le nom de piste spécifié sont installés :

```cpp theme={null}
void CALLBACK ProgressChangedCallback( 
    void* /* context*/, XPackageInstallationMonitorHandle monitor) 
{ 
    XPackageInstallationProgress progress; 
    XPackageGetInstallationProgress(monitor, &progress); 
 
    if (progress.completed) 
    { 
        printf("Track ready\n"); 
        XPackageCloseInstallationMonitorHandle(monitor); 
    } 
} 
 
HRESULT StartMonitoring(XTaskQueueHandle queue, char* trackName) 
{ 
    char id[XPACKAGE_IDENTIFIER_MAX_LENGTH]; 
 
    HRESULT hr = XPackageGetCurrentProcessPackageIdentifier(_countof(id), id); 
    if (FAILED(hr)) return hr; 
 
    XPackageChunkSelector selector; 
    selector.type = XPackageChunkSelectorType::Tag; 
    selector.tag = trackName; 
 
    XPackageInstallationMonitorHandle monitor; 
    hr = XPackageCreateInstallationMonitor( 
        id,         // Identity to be monitored 
        1,          // Number of selectors 
        &selector,  // Selectors 
        1000,       // Resolution of the monitor, in milliseconds 
        queue,      // Queue where updates are performed 
        &monitor); 
    
    if (FAILED(hr)) return hr; 
 
    XTaskQueueRegistrationToken token; 
    hr = XPackageRegisterInstallationProgressChanged( 
        monitor, 
        nullptr, 
        ProgressChangedCallback, 
        &token); 
 
    if (FAILED(hr)) 
    { 
        XPackageCloseInstallationMonitorHandle(monitor); 
    } 
 
    return hr; 
} 
```

Examinons chaque appel d'API dans le code présenté ci-dessus :

```cpp theme={null}
XPackageGetCurrentProcessPackageIdentifier(_countof(id), id); 

```

Tout le contenu installé aura un identificateur unique. Vous pouvez surveiller l'installation de n'importe quel package si vous connaissez son identificateur de package et que vous avez accès à ce contenu. Un processus en cours d'exécution peut obtenir son propre identificateur de package. 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).

```cpp theme={null}
XPackageCreateInstallationMonitor( 
    id,         // Identity to be monitored 
    1,          // Number of selectors 
    &selector,  // Selectors 
    1000,       // Resolution of the monitor, in milliseconds 
    queue,      // Queue where updates are performed 
    &monitor);  
```

Ce code crée un moniteur qui suit l'état de l'installation. Ce moniteur d'installation se met à jour à intervalles réguliers. Pour obtenir la progression actuelle d'une installation, appelez [XPackageGetInstallationProgress](/fr-CA/reference/system/xpackage/functions/xpackagegetinstallationprogress); pour être averti d'un changement pendant une installation, inscrivez un rappel.

Vous pouvez créer le moniteur d'installation pour l'ensemble du package ou pour un sous-ensemble particulier. Ici, vous avez défini un « sélecteur » qui indique que vous souhaitez connaître la progression de l'installation pour un nom de piste. Vous pouvez spécifier une fréquence (dans ce cas, 1 000 ms) qui indique à quelle fréquence le moniteur d'installation mettra à jour son instantané de la progression, jusqu'à cette vitesse. Si aucune progression n'a été réalisée dans ce délai, la mise à jour pourrait être plus lente.

```cpp theme={null}
HRESULT hr = XPackageRegisterInstallationProgressChanged( 
    monitor, 
    this, 
    ProgressChangedCallback,
    &token); 
```

Vous voulez savoir quand le chargement de la piste est terminé, alors vous inscrivez un événement de changement de progression sur le moniteur. Ce rappel sera appelé par l'intermédiaire de la file d'attente de tâches fournie lors de la création du moniteur, à peu près à la fréquence spécifiée dans [XPackageCreateInstallationMonitor](/fr-CA/reference/system/xpackage/functions/xpackagecreateinstallationmonitor). Dans le rappel, vous pouvez afficher la progression dans le jeu ou avertir le jeu qu'une piste est prête.

Dans cet exemple, vous fermez le moniteur d'installation sans désinscrire la notification. La durée de vie d'une notification de moniteur d'installation est liée au moniteur d'installation; par conséquent, la fermeture du moniteur désinscrit toutes les notifications qui lui sont associées.

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

## Voir aussi

[XPackage](/fr-CA/reference/system/xpackage/xpackage_members)


## Related topics

- [XPackageInstallChunks](/fr-CA/reference/system/xpackage/functions/xpackageinstallchunks.md)
- [XPackage](/fr-CA/reference/system/xpackage/xpackage_members.md)
- [Wrappers d'API C# Unity pour le GDK](/fr-CA/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageUpdateInstallationMonitor](/fr-CA/reference/system/xpackage/functions/xpackageupdateinstallationmonitor.md)
- [XPackageCreateInstallationMonitor](/fr-CA/reference/system/xpackage/functions/xpackagecreateinstallationmonitor.md)