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

# Liste de vérification de collaboration graphique avec l'ATG

> Liste de vérification pour solliciter l'XBOX Advanced Technology Group sur les performances GPU : rassemblez les captures PIX, les symboles, les paramètres DXR et les étapes de reproduction avant le contact.

Lorsque vous sollicitez l'**XBOX Advanced Technology Group (ATG)** pour cerner des problèmes de performances graphiques, la qualité des données que vous envoyez détermine la qualité des retours. Cette liste de vérification couvre les informations à rassembler avant la collaboration afin que l'ATG puisse consacrer la réunion à une analyse approfondie plutôt qu'à la prise en main.

<Note>
  Passez toujours par votre contact des relations développeurs / DPM avant de solliciter l'ATG. Il peut vous fournir de nombreuses ressources susceptibles de résoudre vos problèmes avant l'escalade.
</Note>

## Préparation d'une analyse des performances GPU

### 1. Ce qu'il faut envoyer

L'ATG peut soit analyser les **captures PIX que vous fournissez**, soit réaliser lui-même des captures PIX à partir d'un build de votre jeu. **Les captures que vous fournissez sont fortement privilégiées** : elles permettent à l'ATG de commencer l'analyse immédiatement, sans devoir d'abord lancer le jeu, régler les comptes de test et trouver des zones de jeu représentatives. Plus de temps de capture = plus de temps d'analyse.

### 2. Envoyer les captures PIX à l'avance

Transmettez les captures PIX **quelques jours avant** la collaboration prévue. Cela laisse à l'ATG le temps de vérifier que les données sont complètes et que sa version de PIX est compatible avec celle utilisée pour la capture.

### 3. Utiliser les dernières versions de PIX et d'OS Recovery *(recommandé)*

Les dernières versions de PIX et d'OS Recovery apportent des améliorations d'analyse, des correctifs de stabilité, une itération plus rapide et de nouvelles fonctionnalités (DXR, VRS). Vous n'avez **pas** besoin d'installer le dernier GDK ni de recompiler le jeu : un téléchargement distinct est disponible pour les seuls outils GDK.

### 4. Inclure des captures XBOX Series S *(recommandé)*

Les collaborations se concentrent souvent sur la Series X. Ajoutez des **captures Series S** afin que l'ATG puisse identifier des possibilités d'optimisation qui n'apparaissent pas sur Series X.

### 5. Inclure les symboles de shaders dans les captures GPU *(recommandé)*

Les symboles de shaders permettent une analyse plus approfondie, des recommandations d'optimisation des shaders, des retours sur la génération de code du compilateur de shaders et l'expérimentation avec la fonctionnalité **Shader Edit and Continue** de PIX. Utilisez des **Slim PDB** (compilez avec `/Zs`) : ils sont plus rapides et plus petits. Vous n'avez **pas** besoin de fournir des fichiers PDB séparés ; si le Symbols Path est correctement configuré dans les paramètres PIX, l'enregistrement de la capture y intègre les symboles.

### 6. Captures GPU des pires scénarios *(obligatoire)*

Les captures GPU doivent être **représentatives des scènes où le jeu peine le plus**. Cela facilite l'identification des problèmes de performances, évite que l'ATG passe à côté de problèmes importants et produit une liste de recommandations mieux hiérarchisée.

### 7. Désactiver la mise à l'échelle dynamique de la résolution *(obligatoire)*

Désactivez la mise à l'échelle dynamique de la résolution lors des captures GPU. Capturez à la **résolution maximale ciblée** pour toutes les passes de rendu afin que l'ATG voie le véritable coût dans le pire des cas de chaque passe.

### 8. Définir des événements nommés PIX *(obligatoire)*

Les **marqueurs et délimiteurs** PIX sont obligatoires. Ils permettent à l'ATG d'identifier les sous-systèmes, de relier le travail à votre moteur et de produire rapidement des retours exploitables.

### 9. Utiliser des noms de ressources *(facultatif)*

Nommez les ressources avec `ID3D12Object::SetName()`. Des noms explicites pour les cibles de rendu, les textures et les tampons rendent clair l'objectif de chaque draw et de chaque dispatch.

### 10. Captures GPU Trace *(recommandé)*

Les **captures PIX GPU Trace** sont des captures de profilage légères disponibles sur XBOX Series X|S. Elles enregistrent plusieurs images pendant l'exécution du titre et tiennent compte des interactions CPU/GPU/mémoire. Contrairement aux GPU Captures, une Trace est **autonome** : le fichier de capture peut être rejoué sans connexion à un devkit.

### 11. Capture PIX Timing *(facultatif)*

Une capture Timing est utile lorsque la synchronisation CPU↔GPU, le temps de présentation, le rythme des images ou la latence sont en cause.

### 12. Capturer deux images GPU pour le calcul asynchrone inter-images *(recommandé)*

Si le calcul asynchrone s'étend sur deux images (fin de l'image N → début de l'image N+1), incluez une **capture de deux images** afin que l'ATG puisse voir toute la chaîne de dépendances.

### 13. DXR *(obligatoire)*

Activez **Capture All GPU Mapped Memory** dans PIX afin que la structure d'accélération soit entièrement présente. Par défaut, seules les pages touchées par le GPU sont capturées, ce qui ne suffit pas pour l'analyse DXR.

Sur les GDK antérieurs à juin 2023, utilisez `SetCompileTimeShaderPdbPathX` pour produire des PDB de shaders pour DXR.

### 14. Exécuter d'abord la PIX Checklist *(recommandé)*

PIX inclut une fonctionnalité **Checklist** qui signale les possibilités courantes d'optimisation GPU que l'ATG rencontre régulièrement. Les corriger avant la collaboration permet à l'ATG de consacrer la réunion à une analyse plus approfondie plutôt qu'aux optimisations évidentes.

## Résumé

Des données de performances de qualité sont le principal facteur d'une collaboration productive avec l'ATG. En cas de doute, **fournissez plus de données** : la première chose que demande l'ATG, ce sont les captures listées ci-dessus, donc les anticiper accélère toute la collaboration.

## Articles connexes

* [Vue d'ensemble de la collaboration avec l'ATG](/fr/build/atg-engagement/atg-engagement)
* [Liste de vérification de collaboration systèmes avec l'ATG](/fr/build/atg-engagement/atg-systems-engagement)
* [PIX pour XBOX](/fr/tools/tools-console/pix/pix)
* [PIX GPU Captures](/fr/tools/tools-console/pix/gpu/pix-gpu-capture)
* [PIX GPU Trace](/fr/tools/tools-console/pix/gpu-trace/pix-gpu-trace-overview)
* [Compilateur de shaders](/fr/tools/tools-console/shadercompiler/shader-compiler)
* [Référence de l'API PIX3](/fr/reference/tools/pix3/pix3_members)


## Related topics

- [Accéder aux ressources et téléchargements du GDK](/fr/home/onboarding-access/access-resources.md)
- [Accéder aux ressources et aux téléchargements du GDK](/fr-CA/home/onboarding-access/access-resources.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Étapes de test de validation des supports](/fr-CA/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [Porter depuis Steam](/fr-CA/paths/porting/from-steam.md)
