IXtfDeployCallback::OnDeployFileProgress
Rappel appelé pour signaler la progression du déploiement d’un fichier sur la console.Syntaxe
Paramètres
pszFilePathType : LPCWSTR Chemin du fichier en cours de déploiement. ullBytesTransferred
Type : ULONGLONG Nombre d’octets transférés jusqu’à présent. ullFileSize
Type : ULONGLONG Taille totale du fichier en cours de transfert, en octets.
Valeur de retour
Type : HRESULT RetourneS_OK pour poursuivre le déploiement, ou un code d’erreur HRESULT pour annuler le déploiement.
Remarques
Ce rappel est appelé lorsque le système de déploiement transfère des fichiers du PC qui effectue le déploiement vers la console. Ce rappel est appelé une fois pour chaque bloc de mémoire tampon transféré avec succès pour un fichier. Ce rappel est toujours appelé au moins deux fois pour chaque fichier transféré avec succès : une fois au début du déploiement et une fois à la fin du déploiement. Si un fichier de longueur nulle est déployé, les deux appels signalent que zéro octet sur zéro a été transféré. Pour plus d’informations sur la façon dont les fichiers sont évalués et sur le moment où les rappels sont appelés pendant le processus de déploiement, consultez Interface IXtfDeployCallback.Le processus de transfert de fichiers pour le déploiement utilise plusieurs threads. Votre code doit corréler les messages de progression par
pszFilePath et se protéger contre les problèmes de multithreading habituels.IXtfDeployCallback, le processus de déploiement se poursuit si ce rappel retourne S_OK. Si ce rappel retourne un code d’erreur HRESULT, quel qu’il soit, le processus de déploiement est annulé immédiatement. Les fichiers déjà transférés ou supprimés restent en l’état, et les fichiers partiellement transférés sont fermés sous leur forme tronquée. Un autre déploiement doit être effectué pour garantir que tous les fichiers de la console sont complets et à jour.
Configuration requise
En-tête : xtfapplication.h Bibliothèque : xtfapplication.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)Voir aussi
Interface IXtfDeployCallbackXtfApplication