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

# XPackageGetInstallationProgress

> XPackageGetInstallationProgress

# XPackageGetInstallationProgress

Devuelve el progreso actual de la instalación.

## Sintaxis

```cpp theme={null}
void XPackageGetInstallationProgress(  
         XPackageInstallationMonitorHandle installationMonitor,  
         XPackageInstallationProgress* progress  
)  
```

### Parámetros

*installationMonitor*   \_In\_\
Tipo: XPackageInstallationMonitorHandle

Un identificador del monitor de instalación.

*progress*   \_Out\_\
Tipo: [XPackageInstallationProgress\*](/reference/system/xpackage/structs/xpackageinstallationprogress)

Al devolverse, contiene el progreso actual de la instalación.

### Valor devuelto

Tipo: void

## Comentarios

Para obtener el progreso actual de una instalación, llame a [XPackageGetInstallationProgress](/reference/system/xpackage/functions/xpackagegetinstallationprogress); para recibir notificaciones de un cambio durante una instalación, registre una devolución de llamada. Puede crear el monitor de instalación para todo el paquete o para un subconjunto determinado.

Durante un momento de una instalación nueva de contenido nuevo, el runtime no puede calcular el tamaño total del paquete, porque la instalación no ha comenzado por completo. En este caso, el runtime devolverá UINT64\_MAX como valor de totalBytes, y cero o false para todos los demás campos.

Ejemplo:

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

Repasemos cada llamada de API del código mostrado anteriormente:

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

Todo el contenido instalado tendrá un identificador único. Puede supervisar la instalación de cualquier paquete si conoce el identificador del paquete y tiene acceso a ese contenido. Un proceso en ejecución puede obtener su propio identificador de paquete. 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).

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

Esto crea un monitor que realiza un seguimiento del estado de la instalación. Este monitor de instalación se actualiza a sí mismo con una cadencia regular. Para obtener el progreso actual de una instalación, llame a [XPackageGetInstallationProgress](/reference/system/xpackage/functions/xpackagegetinstallationprogress); para recibir notificaciones de un cambio durante una instalación, registre una devolución de llamada.

Puede crear el monitor de instalación para todo el paquete o para un subconjunto determinado. Aquí, ha definido un "selector" que indica que quiere conocer el progreso de la instalación para un nombre de pista. Puede especificar una frecuencia (en este caso, 1000 ms) que indica con qué frecuencia el monitor de instalación actualizará su instantánea del progreso, como máximo a esa velocidad. Si no se ha producido progreso a tiempo, podría ser más lenta.

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

Quiere saber cuándo ha terminado de cargarse la pista, por lo que registra un evento de cambio de progreso en el monitor. Esta devolución de llamada se invocará a través de la cola de tareas que se proporcionó cuando se creó el monitor, aproximadamente con la cadencia especificada en [XPackageCreateInstallationMonitor](/reference/system/xpackage/functions/xpackagecreateinstallationmonitor). Dentro de la devolución de llamada, puede representar el progreso dentro del juego o notificar al juego que una pista está lista.

En este ejemplo, cierra el monitor de instalación pero no anula el registro de la notificación. La duración de una notificación del monitor de instalación está vinculada al monitor de instalación; por lo tanto, cerrar el monitor anula el registro de todas sus notificaciones.

## 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 idioma](/build/core-features/common/packaging/intelligentdelivery-language)

## Consulte también

[XPackage](/reference/system/xpackage/xpackage_members)


## Related topics

- [XPackageInstallationProgressCallback](/es/reference/system/xpackage/functions/xpackageinstallationprogresscallback.md)
- [XPackageRegisterInstallationProgressChanged](/es/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md)
- [XPackageUpdateInstallationMonitor](/es/reference/system/xpackage/functions/xpackageupdateinstallationmonitor.md)
- [XPackage](/es/reference/system/xpackage/xpackage_members.md)
- [XPackageCreateInstallationMonitor](/es/reference/system/xpackage/functions/xpackagecreateinstallationmonitor.md)