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

# Analyser les performances des E/S de fichiers Win32

> Analyser les performances des E/S de fichiers Win32

Cet article explique comment utiliser PIX pour analyser les performances des opérations d'E/S de fichiers Win32. Les [Timing Captures](/fr-CA/tools/tools-console/pix/new-timing-captures) de PIX peuvent collecter des données sur l'utilisation par votre titre des API d'E/S de fichiers Win32 pour accéder aux fichiers. Les données collectées pour les appels à des API telles que `ReadFile` et `WriteFile` incluent le nom du fichier consulté ainsi que le décalage, la taille et la durée de l'accès lui-même. Les piles d'appels complètes de chaque accès aux fichiers sont aussi enregistrées. Si votre titre regroupe des actifs individuels dans un fichier d'archive composite, PIX peut indiquer quels actifs du fichier composite ont été consultés si un [fichier de mappage](#file_io_mapping_files) est fourni.

Lorsque vous collectez des données d'E/S de fichiers, PIX calcule aussi des métriques de bande passante et d'utilisation des appareils de stockage. Vous pouvez consulter les données d'E/S de fichiers dans les vues Timeline, Range Details, Element Details et Metrics des Timing Captures.

Si vous utilisez les API [DirectStorage](/fr-CA/build/console-features/storage/directstorage/directstorage-overview) pour accéder aux fichiers, consultez [Analyser les performances de DirectStorage](/fr-CA/tools/tools-console/pix/pix-directstorage) pour savoir comment utiliser PIX afin d'optimiser votre utilisation de DirectStorage.

## Capturer des données d'E/S de fichiers Win32

Pour capturer des données sur les accès aux fichiers Win32, cochez la case **File accesses** avant de démarrer une Timing Capture, comme illustré dans la figure 1.

**Figure 1. Case à cocher File accesses dans le volet Options.**

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/pix_win32_fileio__collection.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=f3a91be9daaeb029189641e2e65b2e1b" alt="Capture d'écran de l'emplacement de la case à cocher File accesses" width="436" height="523" data-path="images/gdk/tools/pix_win32_fileio__collection.png" />

Lorsque vous cochez la case File accesses, PIX collecte et analyse aussi les accès aux fichiers effectués à l'aide des API `DirectStorage`.

## Analyser les données d'E/S de fichiers Win32 dans les Timing Captures

PIX crée une ligne d'E/S dans la vue Timeline pour chaque lecteur de la console. Un rectangle de couleur représente chaque accès aux fichiers et affiche le nom du fichier consulté. L'extrémité gauche du rectangle représente l'heure de début de l'accès. Sa longueur représente la durée de l'accès. Une info-bulle fournit des détails sur chaque accès.

La figure 2 montre plusieurs lectures d'un fichier nommé *ExampleFileData.dat* sur un lecteur nommé XrfsMap05. Plusieurs rectangles indiquant des accès à *ExampleFileData.dat* se chevauchent dans le temps et sont donc empilés. Cette visualisation représente plusieurs lectures simultanées du fichier.

**Figure 2. Une ligne d'E/S de fichiers dans la vue Timeline.**

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/pix_win32_fileio_lane.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=34ba5d482eb64b143a6dbf5c39100163" alt="Capture d'écran d'une ligne d'E/S de fichiers contenant plusieurs rectangles étiquetés avec des noms de fichiers et une info-bulle fournissant des détails sur un rectangle sélectionné" width="936" height="380" data-path="images/gdk/tools/pix_win32_fileio_lane.png" />

<Note>
  Dans la version d'avril 2020 du Microsoft Game Development Kit (GDK), les chemins de fichiers affichés dans PIX ne sont pas résolus en lettres de lecteur. Les lecteurs auxquels accède un titre sont plutôt identifiés par le préfixe XrfsMap. Par exemple, dans la figure 2, le lecteur étiqueté XrfsMap05 correspond au lecteur G. La correspondance entre les chemins de fichiers sous-jacents et les lettres de lecteur sera ajoutée dans une version ultérieure.
</Note>

Pour afficher les données d'E/S de fichiers Win32 dans un tableau, sélectionnez une plage de temps dans la vue Timeline. Dans la vue **Range Details**, ouvrez le menu **Items to Show**, puis choisissez **File IO Events** (figure 3). L'affichage des données de minutage dans un tableau est utile dans certains scénarios, par exemple pour trier le tableau selon les accès aux fichiers les plus longs.

**Figure 3. Affichage des données d'E/S de fichiers dans un tableau.**

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/pix_win32_fileio_range_details.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=cb166f9f7bf47360b2b1371dac04def9" alt="Capture d'écran d'une plage de temps sélectionnée dans la vue Timeline et d'un tableau des événements d'E/S de fichiers associés dans la vue Range Details" width="1186" height="738" data-path="images/gdk/tools/pix_win32_fileio_range_details.png" />

Sélectionnez une ligne dans **Range Details** pour renseigner la vue **Element Details** avec des données plus détaillées sur l'accès aux fichiers, notamment la pile d'appels de votre titre à l'origine de l'accès (figure 4). Utilisez le bouton **Show in Timeline** pour faire défiler la chronologie jusqu'au moment où l'accès s'est produit.

**Figure 4. Détails d'un accès aux fichiers sélectionné.**

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/pix_win32_fileio_element_details.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=5f42cccc7e26a5f679bb67a37775eb7d" alt="Capture d'écran d'une ligne de tableau décrivant un accès aux fichiers sélectionné dans la vue Range Details et des informations détaillées sur cet accès dans la vue Element Details" width="1510" height="452" data-path="images/gdk/tools/pix_win32_fileio_element_details.png" />

<a id="file_io_mapping_files" />

### Analyser les accès aux fichiers effectués dans des fichiers d'archive

Si votre titre regroupe des actifs individuels dans un fichier d'archive composite, PIX peut indiquer quels actifs du fichier composite ont été consultés à l'aide d'un fichier de mappage. Pour plus de renseignements, consultez [Analyser les accès aux fichiers effectués dans des fichiers d'archive](/fr-CA/tools/tools-console/pix/pix-mappingfiles).

## Métriques de bande passante et d'utilisation des appareils de stockage

Lorsque vous collectez des données d'E/S de fichiers, PIX calcule des compteurs d'utilisation et de bande passante pour chaque appareil de stockage de la console. Vous trouverez ces compteurs sous le nœud *Derived System Metrics/Drive Utilization* du panneau Selector de la vue **Metrics**.

**Figure 5. Compteurs d'utilisation et de bande passante des lecteurs dans la vue Metrics.**

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/pix_win32_fileio_metrics_view_counters.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=20645dc474e8264273101e1a72617518" alt="Capture d'écran des compteurs d'utilisation et de bande passante des lecteurs dans la vue Metrics" width="1387" height="424" data-path="images/gdk/tools/pix_win32_fileio_metrics_view_counters.png" />

L'intégration entre les vues de PIX permet d'établir facilement des corrélations entre les métriques de disque et les données des lectures individuelles. L'image suivante montre une disposition personnalisée composée d'une vue **Metrics**, d'une vue **Range Details** et d'une vue **Element Details**. La vue **Range Details** est configurée pour afficher les données correspondant à la plage de temps sélectionnée dans la vue **Metrics**.

Sélectionnez dans la vue **Metrics** une période correspondant à des pics d'utilisation et de bande passante des lecteurs. La sélection de *File IO Events* dans la liste déroulante *Items to Show* de la vue **Range Details** renseigne le tableau avec l'ensemble des accès aux fichiers effectués par le titre pendant cette période. La sélection d'un accès individuel renseigne la vue **Element Details** avec des détails sur cet accès, notamment la pile d'appels du code du titre à l'origine de l'accès.

**Figure 6. Corrélation entre l'utilisation et la bande passante des appareils de stockage et les accès aux fichiers individuels.**

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/pix_win32_fileio_custom_layout.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=3a1b9af91978490829b44690e579a215" alt="Capture d'écran d'une corrélation entre les métriques des appareils de stockage et les accès aux fichiers individuels" width="1413" height="793" data-path="images/gdk/tools/pix_win32_fileio_custom_layout.png" />

## Configurations des lignes d'E/S de fichiers Win32

Utilisez le panneau Lane Selector et la boîte de dialogue Lane Configurations pour personnaliser l'apparence des lignes d'E/S (figure 5). Les options permettent notamment de réorganiser les lignes, d'afficher ou de masquer des lignes individuelles, et d'ajuster la couleur et la hauteur des marqueurs.

**Figure 7. Le panneau Lane Selector et la boîte de dialogue Lane Configurations.**

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/pix_win32_fileio_lane_config.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=4273261875cd5024cc88a8e55df06368" alt="Capture d'écran du panneau Lane Selector dans la vue Timeline et de la boîte de dialogue Lane Configurations" width="665" height="805" data-path="images/gdk/tools/pix_win32_fileio_lane_config.png" />

## Voir aussi

[Analyser les performances de DirectStorage](/fr-CA/tools/tools-console/pix/pix-directstorage) [Analyser les performances des E/S de fichiers DirectStorage et Win32](/fr-CA/tools/tools-console/pix/fileio-performance) [PIX](/fr-CA/tools/tools-console/pix/pix)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [PIX sur XBOX et Windows pour les titres GDK](/fr-CA/tools/tools-console/pix/index.md)
- [Modèle de chiffrement MSIXVC2](/fr-CA/build/core-features/common/packaging/packaging-encryption-msixvc2.md)
- [Capture GPU et analyse des performances avec PIX](/fr-CA/tools/tools-console/pix/gpu/index.md)
- [Vue d'ensemble de DirectStorage](/fr-CA/build/console-features/storage/directstorage/directstorage-overview.md)
