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

# XPackageFindChunkAvailability

> XPackageFindChunkAvailability

# XPackageFindChunkAvailability

Retourne la disponibilité minimale de l'ensemble des blocs qui correspondent aux sélecteurs spécifiés.

## Syntaxe

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

### 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\_opt\_(selectorCount)\
Type : [XPackageChunkSelector\*](/fr-CA/reference/system/xpackage/structs/xpackagechunkselector)

Tableau de sélecteurs qui spécifient les blocs à vérifier.

*availability*   \_Out\_\
Type : [XPackageChunkAvailability\*](/fr-CA/reference/system/xpackage/enums/xpackagechunkavailability)

Au retour, indique la disponibilité des blocs.

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

**XPackageFindChunkAvailability** prend un tableau de sélecteurs de blocs, trouve les blocs associés, puis retourne la disponibilité minimale de ces blocs. La disponibilité varie selon les valeurs suivantes :

* Ready : Le bloc est déjà installé et peut être lu.
* Pending : Le bloc n'est pas encore installé, mais il le sera.
* Installable : Le bloc ne sera pas installé, mais il pourrait être téléchargé.
* Unavailable : Le bloc ne peut pas être téléchargé.

L'exemple suivant accepte un nom de piste pour un jeu de course et, si la piste n'est pas installée, affiche la taille de téléchargement de la piste :

```cpp theme={null}
HRESULT ListDownloadSize(char* trackName)
{
    XPackageChunkSelector selector;
    selector.type = XPackageChunkSelectorType::Tag;
    selector.tag = trackName;

    char id[XPACKAGE_IDENTIFIER_MAX_LENGTH];
    HRESULT hr = XPackageGetCurrentProcessPackageIdentifier(_countof(id), id);
    if (FAILED(hr)) return hr;

    XPackageChunkAvailability availability;
    hr = XPackageFindChunkAvailability(id, 1, &selector, &availability);
    if (FAILED(hr)) return hr;

    if (availability == XPackageChunkAvailability::Installable)
    {
        uint64_t downloadSize;
        hr = XPackageEstimateDownloadSize(id, 1, &selector, &downloadSize, nullptr);
        if (FAILED(hr)) return hr;

        printf("Download Size for track %s: %I64u\n", trackName, downloadSize);
    }

    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

* [Intelligent Delivery : spécificateurs de balises personnalisées](/fr-CA/build/core-features/common/packaging/intelligentdelivery-custom)
* [Intelligent Delivery : fonctionnalités et recettes](/fr-CA/build/core-features/common/packaging/intelligentdelivery-features-recipes)
* [Intelligent Delivery : spécificateurs de langue](/fr-CA/build/core-features/common/packaging/intelligentdelivery-language)
* [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

- [XPackageFindChunkAvailability](/reference/system/xpackage/functions/xpackagefindchunkavailability.md)
- [Intelligent Delivery: custom tag specifiers](/build/core-features/common/packaging/intelligentdelivery-custom.md)
- [Intelligent Delivery: features and recipes](/build/core-features/common/packaging/intelligentdelivery-features-recipes.md)
- [Intelligent Delivery：features 与 recipes](/zh-CN/build/core-features/common/packaging/intelligentdelivery-features-recipes.md)
- [Intelligent Delivery：自定义标签修饰符](/zh-CN/build/core-features/common/packaging/intelligentdelivery-custom.md)