Skip to main content

XPackageFindChunkAvailability

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

Sintaxis

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). selectorCount   _In_
Tipo: uint32_t
El número de selectores del parámetro selectors. selectors   _In_reads_opt_(selectorCount)
Tipo: XPackageChunkSelector*
Una matriz de selectores que especifica los fragmentos que se van a comprobar. availability   _Out_
Tipo: XPackageChunkAvailability*
Al devolverse, enumera la disponibilidad de los fragmentos.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error.

Comentarios

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

Requisitos

Encabezado: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XPackage
Instalación de streaming y entrega inteligente
Última modificación el 28 de agosto de 2026