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

Devuelve la disponibilidad mínima de la colección de fragmentos que coinciden con los selectores especificados.

## Sintaxis

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

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

Una matriz de selectores que especifica los fragmentos que se van a comprobar.

*availability*   \_Out\_\
Tipo: [XPackageChunkAvailability\*](/reference/system/xpackage/enums/xpackagechunkavailability)

Al devolverse, enumera la disponibilidad de los fragmentos.

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

**XPackageFindChunkAvailability** toma una matriz de selectores de fragmentos, busca los fragmentos asociados y, a continuación, devuelve la disponibilidad mínima de esos fragmentos. La disponibilidad varía según los valores siguientes:

* Ready: el fragmento ya está instalado y se puede leer.
* Pending: el fragmento aún no está instalado, pero lo estará.
* Installable: el fragmento no se instalará, pero podría descargarse.
* Unavailable: el fragmento no se puede descargar.

El ejemplo siguiente acepta un nombre de pista de un juego de carreras y, si la pista no está instalada, imprime el tamaño de descarga de la pista:

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

## Requisitos

**Encabezado:** XPackage.h

**Biblioteca:** xgameruntime.lib

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

## Documentación conceptual

* [Entrega inteligente: especificadores de etiquetas personalizadas](/build/core-features/common/packaging/intelligentdelivery-custom)
* [Entrega inteligente: características y recetas](/build/core-features/common/packaging/intelligentdelivery-features-recipes)
* [Entrega inteligente: especificadores de idioma](/build/core-features/common/packaging/intelligentdelivery-language)
* [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

- [Intelligent Delivery: especificadores de etiqueta personalizada](/es/build/core-features/common/packaging/intelligentdelivery-custom.md)
- [Intelligent Delivery: características y recetas](/es/build/core-features/common/packaging/intelligentdelivery-features-recipes.md)
- [XPackage](/es/reference/system/xpackage/xpackage_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageChunkAvailability](/es/reference/system/xpackage/enums/xpackagechunkavailability.md)