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

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

## 语法

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

### 参数

*context*   \
类型：void\*

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

### 返回值

类型：void

## 备注

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

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

## 要求

**头文件：** pix3.h

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

## 另请参阅

[PIXBeginRetailEvent](/reference/tools/pix3/functions/pixbeginretailevent)\
[pix3](/reference/tools/pix3/pix3_members)\
[PIX（NDA 主题）](/tools/tools-console/pix/pix)


## Related topics

- [PIXBeginRetailEvent](/zh-CN/reference/tools/pix3/functions/pixbeginretailevent_2.md)
- [PIXBeginRetailEvent 函数](/zh-CN/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXEndEvent 函数](/zh-CN/reference/tools/pix3/functions/pixendevent-overloads.md)
- [PIXEndEvent](/zh-CN/reference/tools/pix3/functions/pixendevent_2.md)
- [PIXEndEvent 参考](/zh-CN/reference/tools/pix3/functions/pixendevent.md)