XPackageInstallChunks
Démarre l’installation de blocs.Syntaxe
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. 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 retourne également une valeur booléenne qui indique si la taille est suffisamment grande pour qu’une invite doive être affichée. Si une confirmation de téléchargement est nécessaire, le jeu doit soit l’afficher au moyen de sa propre interface utilisateur, soit laisser XPackageInstallChunks l’afficher. queue _In_opt_
Type : XTaskQueueHandle File d’attente asynchrone dans 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.Retourne une erreur d’annulation si l’installation est refusée.
Remarques
Il n’est pas sécuritaire 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 bloquera jusqu’à ce que l’utilisateur accepte ou refuse le téléchargement. Si l’utilisateur refuse, l’appel échouera avec l’erreur d’annulation E_ABORT. Cette API retourne un moniteur d’installation que vous pouvez utiliser pour surveiller l’état de l’installation. Le moniteur doit finalement être fermé en appelant XPackageCloseInstallationMonitorHandle.
- Affecter la valeur true à suppressUserConfirmation vous permet de fournir une interface utilisateur personnalisée qui demandera à l’utilisateur d’accepter 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 d’étiquettes personnalisés
- Intelligent Delivery : fonctionnalités et recettes
- Intelligent Delivery : spécificateurs de langue
- Intelligent Delivery : contenu OnDemand
- Threads urgents
