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

# PIXEndRetailEvent

> PIXEndRetailEvent

# PIXEndRetailEvent

定义用户定义零售事件的结束。

## 语法

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

### 参数

*context*   \
类型：void\*

事件的上下文，接受 `ID3D12GraphicsCommandList\*`、`ID3D12GraphicsCommandList\*` 和 `ID3D12XboxDmaCommandList\*`（仅限 XBOX）。\
*context* 将 PIX 标记与所设置在其上的 D3D12 对象相关联。

### 返回值

类型：void

## 备注

在调试或检测设备上，`PIXEndERetailEvent` 的行为与 [PIXEndEvent](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixendevent.md) 完全相同。对于零售设备，这些事件将包含在用于 GPU 挂起调试的 HIX 文件中。

每次调用 `PIXEndERetailEvent` 都必须与相应的对 [PIXBeginRetailEvent](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixbeginretailevent.md) 的调用配对。
在最坏情况下，不匹配的事件调用可能会导致 PIX 崩溃。

## 要求

**头文件：** pix3.h

**库：** pixevt.lib
**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[PIXBeginRetailEvent](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixbeginretailevent.md)\
[pix3](https://docs.xbox.com/zh-CN/reference/tools/pix3/pix3_members.md)\
[PIX（NDA 主题）](https://docs.xbox.com/zh-CN/tools/tools-console/pix/pix.md)


## Related topics

- [PIXEndEvent](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixendevent-overloads.md)
- [PIXBeginRetailEvent(void*, UINT64, PCSTR, ...)](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXBeginRetailEvent(void*,UINT64, PCWSTR, ...)](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixbeginretailevent_2.md)
- [PIXEndEvent()](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixendevent.md)
- [PIXEndEvent(void*)](https://docs.xbox.com/zh-CN/reference/tools/pix3/functions/pixendevent_2.md)