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

# PIX3

> PIX3

# PIX3

Microsoft Game Development Kit (GDK) 的 PIX3 API 参考资料。

## 函数

| 函数                                                                                               | 说明                                                                                               |
| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| [ConfigureL2IPMCs](/reference/tools/pix3/functions/configurel2ipmcs)                             | 配置 L2 缓存内部的性能计数器。                                                                                |
| [ConfigureNBPMCs](/reference/tools/pix3/functions/configurenbpmcs)                               | 配置北桥内部的四个硬件性能监视计数器 (PMC)，使标题能够直接读取这些计数器供标题代码使用。                                                  |
| [ConfigurePMCs](/reference/tools/pix3/functions/configurepmcs)                                   | 配置四个硬件性能监视计数器 (PMC)，使标题能够直接读取这些计数器供标题代码使用。                                                       |
| [GetPMCValue](/reference/tools/pix3/functions/getpmcvalue)                                       | 获取硬件性能监视计数器 (PMC) 的值。                                                                            |
| [PIX\_COLOR](/reference/tools/pix3/functions/pix_color)                                          | 为事件指定特定颜色。                                                                                       |
| [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index)                             | 指定一组唯一的事件类别，并让 PIX 选择用于表示每个类别的颜色。                                                                |
| [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)                               | 以编程方式启动受控的 PIX 捕获。                                                                               |
| [PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent-overloads)                         | 为 CPU 活动的时序捕获启动一个用户自定义事件，用于显示在 PIX 的 System Timing Capture 功能中。                                  |
| [PIXEndCapture](/reference/tools/pix3/functions/pixendcapture)                                   | 停止使用 `PIXBeginCapture` 启动的、以编程方式受控的捕获。                                                           |
| [PIXEndEvent](/reference/tools/pix3/functions/pixendevent-overloads)                             | 定义用户自定义事件的结束。                                                                                    |
| [PIXGetCaptureState](/reference/tools/pix3/functions/pixgetcapturestate)                         | 以一组标志的形式检索当前正在进行的捕获类型。                                                                           |
| [PIXGetPowerMetrics (NDA 主题)](/reference/tools/pix3/functions/pixgetpowermetrics)                | 返回 XBOX Series 主机上的当前电源负载                                                                        |
| [PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent) | 记录一次内存分配事件。                                                                                      |
| [PIXRecordMemoryFreeEvent](/reference/tools/pix3/functions/pixrecordmemoryfreeevent)             | 记录一次内存释放事件。                                                                                      |
| [PIXReportCounter](/reference/tools/pix3/functions/pixreportcounter)                             | 在 PIX UI 中显示用户自定义计数器。                                                                            |
| [PIXScopedEvent](/reference/tools/pix3/functions/pixscopedevent-overloads)                       | 为 CPU 活动的时序捕获创建一个用户自定义事件，用于显示在 Performance Investigator for XBOX (PIX) 的 **Timing Capture** 功能中。 |
| [PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker-overloads)                           | 当特定的用户自定义事件发生时，向 PIX System Timing Capture 窗口的 CPU 时间线插入一个标记。                                    |

## 结构

| 结构                                                                         | 说明                     |
| -------------------------------------------------------------------------- | ---------------------- |
| [PIXCaptureParameters](/reference/tools/pix3/structs/pixcaptureparameters) | PIXBeginCapture 的参数。   |
| [PIXPowerMetrics (NDA 主题)](/reference/tools/pix3/structs/pixpowermetrics)  | PIXGetPowerMetrics 的参数 |

<a id="pixgpucaptureapis" />

## PIX GPU 捕获 API

有关更多信息，请参见 [PIX GPU capture APIs (NDA 主题)](/reference/tools/pix3/pix3_gpu_captures)。

## 概念性文档

* [ATG 系统合作检查清单](/build/atg-engagement/atg-systems-engagement)
* [工具和自动化 API](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env)
* [分析 CPU 性能（目录）](/tools/tools-console/pix/cpu-performance)
* [PIX API 参考](/tools/tools-console/pix/pix-api-reference)
* [XBOX Hang Investigation Tool (XHIT)](/tools/tools-console/xhit/xhit-tool)

## 另请参阅

[PIX 概述 (NDA 主题)](/tools/tools-console/pix/pix)<br />[工具 API 参考](/reference/tools/gc-reference-tools-toc)


## Related topics

- [XBOX GDK 主机开发 NDA 主题索引](/zh-CN/nda/nda-overview.md)
- [PIXScopedEvent](/zh-CN/reference/tools/pix3/functions/pixscopedevent-overloads.md)
- [PIXSetMarker](/zh-CN/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [PIXEndCapture](/zh-CN/reference/tools/pix3/functions/pixendcapture.md)
- [PIXBeginEvent 函数](/zh-CN/reference/tools/pix3/functions/pixbeginevent-overloads.md)
