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

PIX3 API reference material for the Microsoft Game Development Kit (GDK).

## Functions

| Function                                                                                         | Description                                                                                                                                                      |
| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [ConfigureL2IPMCs](/reference/tools/pix3/functions/configurel2ipmcs)                             | Configures performance counters inside the L2 caches.                                                                                                            |
| [ConfigureNBPMCs](/reference/tools/pix3/functions/configurenbpmcs)                               | Configures the four hardware Performance Monitor Counters (PMCs) inside the north bridge to enable a title to read the counters directly for the title code.     |
| [ConfigurePMCs](/reference/tools/pix3/functions/configurepmcs)                                   | Configures the four hardware Performance Monitor Counters (PMCs) to enable a title to read the counters directly for the title code.                             |
| [GetPMCValue](/reference/tools/pix3/functions/getpmcvalue)                                       | Gets the value of a hardware Performance Monitor Counter (PMC).                                                                                                  |
| [PIX\_COLOR](/reference/tools/pix3/functions/pix_color)                                          | Specifies a particular color for an event.                                                                                                                       |
| [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index)                             | Specifies a set of unique event categories and lets PIX choose the colors to represent each category.                                                            |
| [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)                               | Starts a programmatically controlled PIX capture.                                                                                                                |
| [PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent-overloads)                         | Starts a user-defined event for a timing capture of CPU activity, to be displayed in the System Timing Capture feature of PIX.                                   |
| [PIXEndCapture](/reference/tools/pix3/functions/pixendcapture)                                   | Stops a programmatically controlled capture that was started with `PIXBeginCapture`.                                                                             |
| [PIXEndEvent](/reference/tools/pix3/functions/pixendevent-overloads)                             | Defines the end of a user-defined event.                                                                                                                         |
| [PIXGetCaptureState](/reference/tools/pix3/functions/pixgetcapturestate)                         | Retrieves the type of captures in progress, as a set of flags.                                                                                                   |
| [PIXGetPowerMetrics (NDA topic)](/reference/tools/pix3/functions/pixgetpowermetrics)             | Returns the current power load on XBOX Series consoles                                                                                                           |
| [PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent) | Records a memory allocation event.                                                                                                                               |
| [PIXRecordMemoryFreeEvent](/reference/tools/pix3/functions/pixrecordmemoryfreeevent)             | Records a memory freeing event.                                                                                                                                  |
| [PIXReportCounter](/reference/tools/pix3/functions/pixreportcounter)                             | Displays a user-defined counter in the PIX UI.                                                                                                                   |
| [PIXScopedEvent](/reference/tools/pix3/functions/pixscopedevent-overloads)                       | Creates a user-defined event for a timing capture of CPU activity, to be displayed in the **Timing Capture** feature of Performance Investigator for XBOX (PIX). |
| [PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker-overloads)                           | Inserts a marker into the CPU timeline in the PIX System Timing Capture window, when a particular user-defined event occurs.                                     |

## Structures

| Structure                                                                    | Description                      |
| ---------------------------------------------------------------------------- | -------------------------------- |
| [PIXCaptureParameters](/reference/tools/pix3/structs/pixcaptureparameters)   | Parameters for PIXBeginCapture.  |
| [PIXPowerMetrics (NDA topic)](/reference/tools/pix3/structs/pixpowermetrics) | Parameter for PIXGetPowerMetrics |

<a id="pixgpucaptureapis" />

## PIX GPU capture APIs

For more information, see [PIX GPU capture APIs (NDA topic)](/reference/tools/pix3/pix3_gpu_captures).

## Conceptual documentation

* [ATG Systems Engagement Checklist](/build/atg-engagement/atg-systems-engagement)
* [Tool and automation APIs](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env)
* [Analyzing CPU performance (contents)](/tools/tools-console/pix/cpu-performance)
* [PIX API reference](/tools/tools-console/pix/pix-api-reference)
* [XBOX Hang Investigation Tool (XHIT)](/tools/tools-console/xhit/xhit-tool)

## See also

[PIX overview (NDA topic)](/tools/tools-console/pix/pix)<br />[Tools API reference](/reference/tools/gc-reference-tools-toc)


## Related topics

- [NDA topics index for XBOX GDK console development](/nda/nda-overview.md)
- [PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker-overloads.md)
- [PIXScopedEvent](/reference/tools/pix3/functions/pixscopedevent-overloads.md)
- [PIXEndCapture](/reference/tools/pix3/functions/pixendcapture.md)
- [PIXReportCounter](/reference/tools/pix3/functions/pixreportcounter.md)