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

# Interface IXtfDeployCallback

> Interface IXtfDeployCallback

# Interface IXtfDeployCallback

Fournit un rappel appelé lorsqu'une action traçable se produit pendant une opération [IXtfApplicationClient::Deploy](/fr/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m).

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
interface IXtfDeployCallback : public IUnknown  
```

## Méthodes

| Méthode | Description |
| - | - |
| [OnDeployChangeEvaluation](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb) | Rappel appelé lors de l'évaluation des fichiers qui doivent être transférés ou supprimés. |
| [OnDeployError](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows) | Réservé à un usage interne. |
| [OnDeployExtraFileDetected](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x) | Rappel appelé lorsqu'un fichier supplémentaire a été détecté. |
| [OnDeployExtraFileRemoved](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb) | Rappel appelé pour signaler qu'un fichier supplémentaire sur la console a été supprimé. |
| [OnDeployFileProgress](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w) | Rappel appelé pour signaler la progression du déploiement d'un fichier sur la console |
| [OnDeployInitialized](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi) | Rappel appelé au début du déploiement. |
| [OnDeployMetrics](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window) | Rappel appelé lorsque les métriques de déploiement sont signalées. |

<a id="requirements" />

## Remarques

Toutes les méthodes de rappel fonctionnent de la même manière en ce qui concerne leurs valeurs de retour. Si un rappel retourne un HResult de réussite, le processus de déploiement se poursuit. Si un rappel retourne un HResult d'échec, 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.

Le processus de rappel est simple. Chaque fichier présent sur le PC de développement qui effectue le déploiement est comparé au fichier correspondant sur la console cible.

* Si un fichier est identique sur le PC et sur la console, rien de plus n'est fait.
* Si un fichier sur le PC est plus récent que le fichier sur la console, le fichier est copié du PC vers la console.
* Si un fichier existe sur le PC et pas sur la console, il est copié sur la console.
* Si un fichier existe sur la console, mais pas sur le PC, il est éventuellement supprimé de la console. (Sa suppression est déterminée par la valeur du paramètre fRemoveExtraFiles de [Deploy](/fr/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m)).

Les méthodes de rappel sont appelées au moment approprié pendant le processus de déploiement.

1. [OnDeployInitialized](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi) : ce rappel est appelé lorsque le système de déploiement a été engagé, et peut servir à démarrer le chronométrage du déploiement ou à initialiser des boîtes de dialogue de progression. Lorsque ce rappel a été appelé, tous les franchissements potentiels de limites d'interopérabilité et de DLL ont été effectués avec succès. Ce rappel est appelé une fois par déploiement.
2. [OnDeployChangeEvaluation](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb) : ce rappel est appelé lorsque le système de déploiement évalue les fichiers qui doivent être déployés sur la console ou supprimés de la console. Vous pouvez utiliser ce rappel pour mettre à jour un indicateur de progression.
3. [OnDeployMetrics](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window) : ce rappel est appelé une fois à la fin du processus d'évaluation, pour signaler le nombre de fichiers qui seront déployés sur la console et le nombre total d'octets à transférer.
4. [OnDeployFileProgress](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w) : ce rappel est appelé chaque fois qu'un bloc de mémoire tampon est transféré avec succès, pour chaque fichier. Les transferts sont effectués simultanément sur plusieurs threads ; votre code doit donc suivre la progression par nom de fichier et se protéger contre les problèmes de multithreading habituels. Ce rappel est appelé une fois au début d'un transfert et une fois à la fin du transfert ; un fichier de longueur nulle provoque donc deux appels de ce rappel.
5. [OnDeployExtraFileDetected](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x) : indique qu'un fichier a été trouvé sur la console alors qu'il n'est pas sur le PC.
6. [OnDeployExtraFileRemoved](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb) : si le paramètre fRemoveExtraFiles de [Deploy](/fr/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m) a été défini sur TRUE, ce rappel est appelé lorsqu'un fichier est supprimé de la console.
7. [OnDeployError](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows) n'est pas utilisé par l'implémentation actuelle, mais est réservé à un usage futur.

Si vous souhaitez indiquer la progression globale du déploiement, votre code doit signaler le nombre de fichiers distincts nommés jusqu'à présent dans les rappels OnDeployFileProgress, sous forme de pourcentage du nombre total de fichiers signalé au rappel OnDeployMetrics.

## Configuration requise

**En-tête :** xtfapplication.h

**Bibliothèque :** xtfapplication.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="ID4EKD" />

## Voir aussi

<a id="ID4EMD" />

##### Référence

[XtfApplication](/fr/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfDeployCallback::OnDeployError](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)
- [IXtfDeployCallback::OnDeployFileProgress](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md)
- [IXtfDeployCallback::OnDeployInitialized Method](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md)
- [IXtfDeployCallback::OnDeployMetrics method](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)
- [IXtfDeployCallback::OnDeployChangeEvaluation](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md)
