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

# PIXEndRetailEvent

> PIXEndRetailEvent

# PIXEndRetailEvent

Defines the end of a user-defined retail event.

## Syntax

```cpp theme={null}
void PIXEndRetailEvent(  
         void* context  
)  
```

### Parameters

*context*   \
Type: void\*

Context for the event, accepts `ID3D12GraphicsCommandList\*`, `ID3D12GraphicsCommandList\*`, and `ID3D12XboxDmaCommandList\*` (XBOX only).\
The *context* associates the PIX marker with the D3D12 object it is set on.

### Return value

Type: void

## Remarks

With a debug or instrumented device, `PIXEndERetailEvent` behaves identically to [PIXEndEvent](/reference/tools/pix3/functions/pixendevent). For a retail device, the events will be included in HIX files for GPU hang debugging.

Each call to `PIXEndERetailEvent` must be paired with a corresponding call to [PIXBeginRetailEvent](/reference/tools/pix3/functions/pixbeginretailevent).
In a worst case scenario, mismatched event calls may cause PIX to crash.

## Requirements

**Header:** pix3.h

**Library:** pixevt.lib
**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[PIXBeginRetailEvent](/reference/tools/pix3/functions/pixbeginretailevent)\
[pix3](/reference/tools/pix3/pix3_members)\
[PIX (NDA topic)](/tools/tools-console/pix/pix)


## Related topics

- [PIXEndEvent function](/reference/tools/pix3/functions/pixendevent-overloads.md)
- [PIXBeginRetailEvent](/reference/tools/pix3/functions/pixbeginretailevent_2.md)
- [PIXBeginRetailEvent function](/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXEndEvent](/reference/tools/pix3/functions/pixendevent_2.md)
- [PIXEndEvent reference](/reference/tools/pix3/functions/pixendevent.md)