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

# PIXBeginRetailEvent

> PIXBeginRetailEvent

# PIXBeginRetailEvent

사용자 정의 retail 이벤트를 시작합니다.

## Syntax

```cpp theme={null}
void PIXBeginRetailEvent(  
         void* context,  
         UINT64 color,  
         PCWSTR formatString,
         ...  
)  
```

### Parameters

*context*   \
Type: void\*

이벤트의 컨텍스트로, `ID3D12GraphicsCommandList\*`, `ID3D12GraphicsCommandList\*` 및 `ID3D12XboxDmaCommandList\*`(XBOX 전용)를 허용합니다.

*color*   \
Type: UINT64

시스템 타이밍 차트에 사용할 이벤트 색상입니다. 색상을 지정하려면 [PIX\_COLOR](/reference/tools/pix3/functions/pix_color)을 사용하고, 색상 인덱스를 지정하려면 [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index)를 사용하거나, 형식이 ARGB이고 알파 채널 값이 0xff이어야 함에 유의하여 원시 DWORD 값을 전달합니다.\
*formatString*   \_In\_\
Type: PCWSTR

이벤트를 설명하는 데 사용할 이름으로, null로 종료되는 유니코드 문자열에 대한 포인터입니다. 문자열에는 `sprintf` 형식과 매우 유사한 선택적 문자열 형식 자리 표시자를 0개 이상 지정할 수 있습니다.

Type: ...

*formatString*에 자리 표시자가 사용된 경우, 그에 상응하는 개수의 매개 변수가 있어야 하며 그 형식은 자리 표시자에 따라 다릅니다. 이 메서드는 최대 16개의 형식 매개 변수를 지원합니다.

### Return value

Type: void

## Remarks

디버그 또는 계측된 디바이스에서 `PIXBeginRetailEvent`는 [PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent)와 동일하게 동작합니다. retail 디바이스의 경우 GPU 중단 디버깅을 위해 이벤트가 HIX 파일에 포함됩니다.

`PIXBeginRetailEvent`와 `PIXEndRetailEvent` 쌍은 원하는 깊이만큼 중첩할 수 있습니다.

## Requirements

**Header:** pix3.h

**Library:** pixevt.lib
**Supported platforms:** XBOX One 계열 콘솔 및 XBOX Series 콘솔

## See also

[PIX (NDA topic)](/tools/tools-console/pix/pix)\
[pix3](/reference/tools/pix3/pix3_members)\
[PIXEndRetailEvent](/reference/tools/pix3/functions/pixendretailevent)\
[PIXBeginRetailEvent(void\*, UINT64, PCSTR, ...)](/reference/tools/pix3/functions/pixbeginretailevent)


## Related topics

- [PIXBeginRetailEvent function](/ko/reference/tools/pix3/functions/pixbeginretailevent.md)
- [PIXEndRetailEvent](/ko/reference/tools/pix3/functions/pixendretailevent.md)
- [PIXBeginEvent Function](/ko/reference/tools/pix3/functions/pixbeginevent-overloads.md)
- [PIXSetRetailMarker](/ko/reference/tools/pix3/functions/pixsetretailmarker_2.md)
- [PIXSetRetailMarker function](/ko/reference/tools/pix3/functions/pixsetretailmarker.md)