XPackageInstallChunks
Démarre l’installation de blocs.Syntaxe
Paramètres
packageIdentifier _In_z_Type : char* Chaîne qui identifie de manière unique le package installé sur le disque. Pour plus d’informations sur les identificateurs de package, consultez Gérer et octroyer des licences pour le contenu téléchargeable (DLC). selectorCount _In_
Type : uint32_t Nombre de sélecteurs dans le paramètre selectors. selectors _In_reads_(selectorCount)
Type : XPackageChunkSelector* Tableau de sélecteurs qui spécifient les blocs à installer. minimumUpdateIntervalMs _In_
Type : uint32_t Intervalle entre les mises à jour, en millisecondes. suppressUserConfirmation _In_
Type : bool Si les blocs à installer dépassent une taille prédéfinie, une invite de confirmation s’affiche. Si suppressUserConfirmation a la valeur true, aucune invite ne s’affiche et l’installation se poursuit comme si l’utilisateur avait accepté. Cela permet au jeu de présenter sa propre interface utilisateur. Si le jeu utilise cette option, il doit également appeler XPackageEstimateDownloadSize pour obtenir la taille qui sera présentée à l’utilisateur. XPackageEstimateDownloadSize renvoie également un booléen indiquant si la taille est suffisamment importante pour qu’une invite soit affichée. Si une confirmation de téléchargement est nécessaire, le jeu doit soit l’afficher à l’aide de sa propre interface utilisateur, soit laisser XPackageInstallChunks l’afficher. queue _In_opt_
Type : XTaskQueueHandle File d’attente asynchrone sur laquelle le travail sera effectué. installationMonitor _Out_
Type : XPackageInstallationMonitorHandle* Au retour, contient un handle vers un moniteur d’installation qui surveillera l’installation des blocs correspondant au sélecteur.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT.Renvoie une erreur d’annulation si l’installation est refusée.
Remarques
Il n’est pas sûr d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
- Si vous utilisez la version synchrone de cette API, elle reste bloquée jusqu’à ce que l’utilisateur accepte ou refuse le téléchargement. Si l’utilisateur refuse, l’appel échoue avec l’erreur d’annulation E_ABORT. Elle renvoie un moniteur d’installation que vous pouvez utiliser pour surveiller l’état de l’installation. Le moniteur doit finalement être fermé en appelant XPackageCloseInstallationMonitorHandle.
- Définir suppressUserConfirmation sur true vous permet de fournir une interface utilisateur personnalisée qui demandera à l’utilisateur de confirmer le téléchargement.
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 SeriesDocumentation conceptuelle
- Intelligent Delivery : spécificateurs de balises personnalisées
- Intelligent Delivery : fonctionnalités et recettes
- Intelligent Delivery : spécificateurs de langue
- Intelligent Delivery : contenu OnDemand
- Threads urgents
