> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 面向 GDK 游戏的 PIX on XBOX 与 Windows

> 面向 XBOX 与 Windows GDK 游戏的 PIX 性能调优与调试工具，包括 GPU 捕获、GPU 跟踪、Shader Explorer 与 PIX 可扩展性。

PIX 相关文档。

## 子主题

> **[扩展性](https://docs.xbox.com/zh-CN/tools/tools-console/pix/extensibility/index.md)**
>
> 扩展性相关文档。

> **[GPU](https://docs.xbox.com/zh-CN/tools/tools-console/pix/gpu/index.md)**
>
> GPU 相关文档。

> **[GPU Trace](https://docs.xbox.com/zh-CN/tools/tools-console/pix/gpu-trace/index.md)**
>
> GPU Trace 相关文档。

> **[Shader Explorer](https://docs.xbox.com/zh-CN/tools/tools-console/pix/shader-explorer/index.md)**
>
> Shader Explorer 相关文档。

## 指南

> **[分析 title 性能](https://docs.xbox.com/zh-CN/tools/tools-console/pix/analyzing-system-performance.md)**
>
> 概述 介绍 PIX 作为面向构建 DirectX 12 title 的游戏开发者的性能调优与调试工具。

> **[配置 PIX UI](https://docs.xbox.com/zh-CN/tools/tools-console/pix/configuring-pix.md)**
>
> 可以自定义 PIX 用于设备连接选项卡以及每种捕获类型的默认窗口布局。

> **[分析 CPU 性能](https://docs.xbox.com/zh-CN/tools/tools-console/pix/cpu-performance.md)**
>
> PIX 包含多种功能和捕获类型，可帮助你解决 CPU 性能问题。

> **[分析 DirectStorage 与 Win32 文件访问](https://docs.xbox.com/zh-CN/tools/tools-console/pix/fileio-performance.md)**
>
> PIX Timing Captures 包含用于分析 title 文件访问性能的功能。

> **[启动 PIX、连接主机](https://docs.xbox.com/zh-CN/tools/tools-console/pix/launching-and-connecting.md)**
>
> Gaming eXtensions Development Kit (GXDK) 安装程序会将 PIX 安装到你的……的 C:\Program Files (x86)\Microsoft GDK\bin 文件夹中。

> **[分析内存使用与性能](https://docs.xbox.com/zh-CN/tools/tools-console/pix/memory-performance.md)**
>
> PIX 提供了多种功能和捕获类型，帮助你诊断与内存使用和性能相关的问题。

> **[PIX Timing Captures](https://docs.xbox.com/zh-CN/tools/tools-console/pix/new-timing-captures.md)**
>
> a id="timing\_capture\_overview"/a

> **[打开程序化 Timing Captures](https://docs.xbox.com/zh-CN/tools/tools-console/pix/open-offline-timing-captures.md)**
>
> 使用 PIXBeginCapture API 得到的捕获必须经过转换处理才能在 PIX 中查看。

> **[PIX API](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-api-reference.md)**
>
> PIX 提供了一组 API，可用于多种任务，包括记录 timing 数据、提供软件计数器等……

> **[分析 title 的初始化过程](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-capture-from-launch.md)**
>
> title 的启动过程通常涉及大量的内存分配和文件 IO 操作，以及其他初始化任务。

> **[分析停顿与上下文切换](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-context-switches.md)**
>
> 本主题介绍如何使用 PIX 分析停顿与上下文切换。

> **[将 etl 文件转换为 timing](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-convert-etl-files.md)**
>
> PIX 主页选项卡下的 Convert 菜单可用于通过转换由 xbPerf、xperf……收集的 etl 文件来创建 Timing Capture。

> **[转换旧版本的 timing](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-convert-timing-captures.md)**
>
> 在某些 PIX 发布版本中，随着新功能加入，Timing Capture 文件格式需要发生变化。

> **[配置 PIX 访问 CPU 相关的 PDB](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-cpu-pdb-config.md)**
>
> PIX 中的 CPU 捕获需要访问 title 的 Program Database (PDB)，以便在调用堆栈和采样中正确显示函数名称……

> **[分析 PIX 中的关键路径](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-critical-path.md)**
>
> PIX 会分析 Timing Capture 期间收集的上下文切换数据，以计算所选 PIX 事件的关键路径。

> **[PIX 自定义内存分配器](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-custom-memory-allocators.md)**
>
> PIX timing captures 可以跟踪你的自定义内存分配器所做的内存分配和释放操作。

> **[分析 DirectStorage 性能](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-directstorage.md)**
>
> PIX Timing Captures 包含可选项，用于收集 title 使用 DirectStorage 的数据。

> **[GPU 调试指南](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-gpu-debugging.md)**
>
> 在游戏开发过程中，你可能会遇到各种问题，例如渲染损坏、故障、GPU 卡死、页面错误等。

> **[分析动态延迟输入](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-input-sync.md)**
>
> PIX Timing Captures 包含可选项，用于收集输入读取以及 Dynamic Latency Input (DLI) 的数据。

> **[指令跟踪捕获](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-instruction-trace-captures.md)**
>
> a id="itrace\_overview"/a

> **[Memory Pies](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-live-memory-pies.md)**
>
> 当 title 暂停时，可以使用 PIX 中的 Memory Pies 视图。

> **[PIX Live](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-live.md)**
>
> 在 PIX 中连接到主机时，PIX 可以通过位于……旁边的暂停/播放按钮暂停和恢复正在运行的 title。

> **[分析发生的文件访问](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-mappingfiles.md)**
>
> a id="file\_io\_mapping\_files"/a

> **[PIX Timing Captures 中的 metrics 视图](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-metrics-view.md)**
>
> Metrics View 是一个图形化工具，帮助你在大量数据中快速找到与……相关的重点区域。

> **[检测违反写入策略的情况](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-nvme-write-monitor.md)**
>
> 本主题介绍如何使用 PIX 检测何时向本地存储写入了过多数据。

> **[PIX 按需实时调试](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-on-demand-live-debugging.md)**
>
> 按需实时调试可用于在卡死和异常场景之外实时调试 XBOX GPU。

> **[分析 timing 捕获中的 CPU 采样](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-sampling-profiler.md)**
>
> PIX 包含一个 CPU 采样分析器，可以在采集 Timing Capture 时选择性地运行。

> **[保存与加载 PIX 设置](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-save-load-settings.md)**
>
> 可从 PIX 主页选项卡访问的 Settings 布局提供了多个用于配置 PIX 用户界面各方面的控件……

> **[GPU 捕获中的着色器异常检测](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-shader-exception-detection.md)**
>
> 从 2023 年 6 月的 GDK 起，可以在 GPU 捕获中检测抛出异常的着色器。

> **[面向着色器异常的 PIX 实时调试](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-shader-exceptions-live-debugging.md)**
>
> 实时调试可用于检测抛出异常的着色器并进行实时调试。

> **[System Monitor](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-system-monitor.md)**
>
> PIX System Monitor 通过实时查看从主机流式传出的计数器数据，实现对 title 的实时分析。

> **[Timing Capture 书签](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-timing-capture-bookmarks.md)**
>
> 从 Microsoft Game Development Kit 2024 年 6 月版起，开发者可以在……中的通道上添加书签或注释。

> **[Timing Capture 比较功能](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-timing-capture-compare.md)**
>
> Timing Captures 包含一个 Comparison Layout，可以针对代表……的点的平均持续时间生成统计比较。

> **[查询 Timing Capture 文件格式](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-timing-capture-sqlite-queries.md)**
>
> Timing Capture 的文件格式是一个 Sqlite 数据库。

> **[Timing Capture Summary 布局](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-timing-capture-summary-layout.md)**
>
> 当打开 Timing Capture 时，PIX 会执行初步分析，产生捕获统计数据以及一组潜在的候选项……

> **[分析 timing 中的 D3D API 对象使用](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-timing-captures-d3d-objects.md)**
>
> PIX Timing Captures 包含可选项，用于记录在捕获期间分配和释放的所有 D3D 资源和堆对象的信息……

> **[分析内存使用与性能](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-timing-captures-memory.md)**
>
> PIX Timing Captures 包含可选项，用于记录在捕获期间发生的内存分配、访问和释放信息……

> **[PIX 视频](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-videos.md)**
>
> PIX on Windows 概览

> **[分析 Win32 文件 IO 性能](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix-win32-fileio.md)**
>
> 本文介绍如何使用 PIX 分析 Win32 文件 IO 操作的性能。

> **[PIX](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix.md)**
>
> Performance Investigator for XBOX (PIX) 是面向构建 DirectX12 title 的游戏开发者的性能调优与调试工具。

> **[配置主机以使用 PIX](https://docs.xbox.com/zh-CN/tools/tools-console/pix/required-xconfig-settings.md)**
>
> 使用 PIX 进行捕获要求 Profiling mode 主机设置为 On，如下图所示。

> **[安装与快速上手](https://docs.xbox.com/zh-CN/tools/tools-console/pix/setup-getting-started.md)**
>
> 本节介绍如何使用 PIX 完成以下操作。

## 另请参阅

* [Commandlinetools](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/index.md)
* [Console commandlinetools](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/index.md)
* [Devhome](https://docs.xbox.com/zh-CN/tools/tools-console/devhome/index.md)
* [Devkitagent](https://docs.xbox.com/zh-CN/tools/tools-console/devkitagent/index.md)
* [Hix](https://docs.xbox.com/zh-CN/tools/tools-console/hix/index.md)
* [PGO](https://docs.xbox.com/zh-CN/tools/tools-console/pgo/index.md)
* [Shadercompiler](https://docs.xbox.com/zh-CN/tools/tools-console/shadercompiler/index.md)
* [Titleperfoverlay](https://docs.xbox.com/zh-CN/tools/tools-console/titleperfoverlay/index.md)
* [Visualstudio](https://docs.xbox.com/zh-CN/tools/tools-console/visualstudio/index.md)
* [Wdp](https://docs.xbox.com/zh-CN/tools/tools-console/wdp/index.md)
* [Xbom](https://docs.xbox.com/zh-CN/tools/tools-console/xbom/index.md)
* [Xbwatson](https://docs.xbox.com/zh-CN/tools/tools-console/xbWatson/index.md)
* [Xhit](https://docs.xbox.com/zh-CN/tools/tools-console/xhit/index.md)


## Related topics

- [面向 XBOX 与 PC 游戏的通用 GDK 功能](https://docs.xbox.com/zh-CN/build/core-features/common/index.md)
- [XBOX GDK 游戏的输入 API 与硬件](https://docs.xbox.com/zh-CN/build/core-features/common/input/index.md)
- [XBOX 与 PC 上的 Lighting API 与 LampArray](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/index.md)
- [游戏网状通信：GDK 与 XDK 的差异](https://docs.xbox.com/zh-CN/build/console-features/networking/xdk-migration/xdk-migration-game-mesh-networking.md)
- [使用 GDK 在 XBOX 与 PC 上进行图形开发](https://docs.xbox.com/zh-CN/build/core-features/graphics/index.md)