> ## 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.
# Analisar o desempenho de E/S de arquivos do Win32
> Analisar o desempenho de E/S de arquivos do Win32
Este artigo descreve como usar o PIX para analisar o desempenho das operações de E/S de arquivos do Win32. As [Timing Captures](/pt-BR/tools/tools-console/pix/new-timing-captures) do PIX podem coletar dados sobre o uso que o seu título faz das APIs de E/S de arquivos do Win32 para acessar arquivos. Os dados coletados para chamadas a APIs como `ReadFile` e `WriteFile` incluem o nome do arquivo acessado e o deslocamento, o tamanho e a duração do próprio acesso. Também são registradas as pilhas de chamadas completas de cada acesso a arquivo. Se o seu título empacota ativos individuais em um arquivo de pacote composto, o PIX pode mostrar quais ativos dentro do arquivo composto foram acessados se for fornecido um [arquivo de mapeamento](#file_io_mapping_files).
Quando você coleta dados de E/S de arquivos, o PIX também calcula métricas de largura de banda e utilização dos dispositivos de armazenamento. Você pode ver os dados de E/S de arquivos nas exibições Timeline, Range Details, Element Details e Metrics das Timing Captures.
Se você estiver usando as APIs do [DirectStorage](/pt-BR/build/console-features/storage/directstorage/directstorage-overview) para acesso a arquivos, veja [Analisar o desempenho do DirectStorage](/pt-BR/tools/tools-console/pix/pix-directstorage) para obter informações sobre como usar o PIX para otimizar seu uso do DirectStorage.
## Capturar dados de E/S de arquivos do Win32
Para capturar dados sobre acessos a arquivos do Win32, marque a caixa de seleção **File accesses** antes de iniciar uma Timing Capture, conforme mostrado na figura 1.
**Figura 1. Caixa de seleção File accesses no painel Options.**
Quando você marca a caixa de seleção File accesses, o PIX coleta e analisa os acessos a arquivos que usam as APIs do `DirectStorage`.
## Analisar dados de E/S de arquivos do Win32 em Timing Captures
O PIX cria uma faixa de E/S na exibição Timeline para cada unidade do console. Um retângulo colorido representa cada acesso a arquivo e exibe o nome do arquivo acessado. A extremidade esquerda do retângulo representa o horário de início do acesso. O comprimento representa a duração do acesso. Uma dica de ferramenta fornece detalhes de cada acesso.
A figura 2 mostra várias leituras de um arquivo chamado *ExampleFileData.dat* em uma unidade chamada XrfsMap05. Vários retângulos que indicam acessos a *ExampleFileData.dat* se sobrepõem no tempo e, portanto, estão empilhados. Essa visualização representa várias leituras simultâneas do arquivo.
**Figura 2. Uma faixa de E/S de arquivos na exibição Timeline.**
Na versão de abril de 2020 do Microsoft Game Development Kit (GDK), os caminhos de arquivo mostrados no PIX não são resolvidos para letras de unidade. Em vez disso, as unidades que um título está acessando são identificadas com o prefixo XrfsMap. Por exemplo, na figura 2, a unidade rotulada XrfsMap05 é a unidade G. O mapeamento entre os caminhos de arquivo subjacentes e as letras de unidade será adicionado em uma versão futura.
Para ver os dados de E/S de arquivos do Win32 em uma tabela, selecione um intervalo de tempo na exibição Timeline. Na exibição **Range Details**, abra o menu **Items to Show** e escolha **File IO Events** (figura 3). Ver os dados de tempo em uma tabela é útil em determinados cenários, como classificar a tabela pelos acessos a arquivos que demoraram mais para serem concluídos.
**Figura 3. Ver dados de E/S de arquivos em uma tabela.**
Selecione uma linha em **Range Details** para preencher a exibição **Element Details** com dados mais detalhados sobre o acesso ao arquivo, incluindo a pilha de chamadas do seu título que iniciou o acesso (figura 4). Use o botão **Show in Timeline** para rolar a Timeline até o momento em que o acesso ocorreu.
**Figura 4. Detalhes sobre um acesso a arquivo selecionado.**
### Analisar acessos a arquivos que ocorrem dentro de arquivos de pacote
Se o seu título empacota ativos individuais em um arquivo de pacote composto, o PIX pode mostrar quais ativos dentro do arquivo composto foram acessados usando um arquivo de mapeamento. Para obter mais informações, veja [Analisar acessos a arquivos que ocorrem dentro de arquivos de pacote](/pt-BR/tools/tools-console/pix/pix-mappingfiles).
## Métricas de largura de banda e utilização dos dispositivos de armazenamento
Quando você coleta dados de E/S de arquivos, o PIX calcula contadores de utilização e largura de banda de unidade para cada dispositivo de armazenamento do console. Você pode encontrar esses contadores no nó *Derived System Metrics/Drive Utilization* do painel Selector da exibição **Metrics**.
**Figura 5. Contadores de utilização e largura de banda de unidade na exibição Metrics.**
A integração entre as exibições do PIX facilita estabelecer correlações entre as métricas de disco e os dados de leituras individuais. A imagem a seguir mostra um layout personalizado composto por uma exibição **Metrics**, uma exibição **Range Details** e uma exibição **Element Details**. A exibição **Range Details** está configurada para exibir os dados correspondentes ao intervalo de tempo selecionado na exibição **Metrics**.
Você seleciona um período na exibição **Metrics** que corresponde a picos de utilização e largura de banda da unidade. Selecionar *File IO Events* na lista suspensa *Items to Show* da exibição **Range Details** preenche a tabela com o conjunto de acessos a arquivos feitos pelo título durante esse período. Selecionar um acesso individual preenche a exibição **Element Details** com detalhes sobre esse acesso, incluindo a pilha de chamadas do código do título que iniciou o acesso.
**Figura 6. Correlacionar a utilização e a largura de banda do dispositivo de armazenamento com acessos individuais a arquivos.**
## Configurações de faixa de E/S de arquivos do Win32
Use o painel Lane Selector e a caixa de diálogo Lane Configurations para personalizar a aparência das faixas de E/S (figura 5). As opções incluem reordenar faixas, exibir ou ocultar faixas individuais e ajustar a cor e a altura dos marcadores.
**Figura 7. O painel Lane Selector e a caixa de diálogo Lane Configurations.**
## Veja também
[Analisar o desempenho do DirectStorage](/pt-BR/tools/tools-console/pix/pix-directstorage) [Analisar o desempenho de E/S de arquivos do DirectStorage e do Win32](/pt-BR/tools/tools-console/pix/fileio-performance) [PIX](/pt-BR/tools/tools-console/pix/pix)
## Related topics
- [PIX no XBOX e no Windows para títulos GDK](/pt-BR/tools/tools-console/pix/index.md)
- [Modelo de criptografia do MSIXVC2](/pt-BR/build/core-features/common/packaging/packaging-encryption-msixvc2.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Captura de GPU e análise de desempenho do PIX](/pt-BR/tools/tools-console/pix/gpu/index.md)
- [Visão geral do DirectStorage](/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md)