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

# PIXBeginEvent function reference

> PIXBeginEvent function reference

# PIXBeginEvent function reference

PIX의 **System Timing Capture** 기능에 표시할, CPU 활동의 타이밍 캡처를 위한 사용자 정의 이벤트를 시작합니다.

## Syntax

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

### Parameters

*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

`PIXBeginEvent` 함수는 런타임에 문자열을 형식화하는 대신 형식 문자열과 형식 매개 변수를 저장합니다. 그런 다음 PIX에서 캡처 파일을 읽을 때 형식화가 수행됩니다. 최상의 성능을 얻으려면 PIXBeginEvent에 16바이트로 정렬된 문자열(권장) 또는 8바이트로 정렬된 문자열을 사용합니다.

%p 형식 지정자를 사용하여 char\* 또는 wchar\_t\*를 포인터로 인쇄하려면, `PIXBeginEvent`에 전달할 때 포인터를 void\* 또는 정수형이나 부동 소수점 형식에 대한 포인터로 캐스팅합니다. 최상의 성능을 얻으려면 정적으로 할당된 문자열을 사용합니다.

`PIXBeginEvent` 호출에는 형식 문자열과 모든 변수의 전체 크기 및 정렬을 포함하는 레코드 데이터를 저장할 수 있도록 최소 512바이트의 공간이 보장됩니다. 일반적으로 PIX 이벤트는 게임의 주요 구성 요소, 시스템 또는 콘텐츠에 맞춰진 짧은 고성능 마커를 위한 것입니다.

이 메서드는 CPU 이벤트의 시간을 측정하는 데 사용됩니다. GPU 이벤트의 시간 측정에 대한 자세한 내용은 [PIX3](/reference/tools/pix3/pix3_members)의 [PIX GPU Capture APIs](/reference/tools/pix3/pix3_members#pixgpucaptureapis) 섹션을 참조하세요.

`PIXBeginEvent`에 대한 각 호출에는 이에 대응하는 [PIXEndEvent](/reference/tools/pix3/functions/pixendevent) 호출이 있어야 합니다. `PIXBeginEvent`와 [PIXEndEvent](/reference/tools/pix3/functions/pixendevent)의 짝을 이루는 호출은 동일한 스레드에서 이루어져야 합니다. 타이밍 간격은 약 200ns이고 이 함수를 사용하는 오버헤드가 낮으므로 초당 수십만 건까지 `PIXBeginEvent` 호출이 가능합니다.

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

## Requirements

**Header:** pix3.h

**Library:** pixevt.lib

**Supported platforms:** XBOX One 계열 콘솔 및 XBOX Series 콘솔

## See also

[PIXEndEvent](/reference/tools/pix3/functions/pixendevent)\
[PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent)\
[PIXBeginEvent\_3](/reference/tools/pix3/functions/pixbeginevent_3)\
[PIXBeginEvent\_4](/reference/tools/pix3/functions/pixbeginevent_4)\
[PIX3](/reference/tools/pix3/pix3_members)\
[PIX (NDA topic)](/tools/tools-console/pix/pix)


## Related topics

- [PIXBeginEvent function](/ko/reference/tools/pix3/functions/pixbeginevent.md)
- [PIXBeginEvent Function](/ko/reference/tools/pix3/functions/pixbeginevent-overloads.md)
- [PIXBeginEvent reference](/ko/reference/tools/pix3/functions/pixbeginevent_3.md)
- [PIXBeginEvent overview](/ko/reference/tools/pix3/functions/pixbeginevent_4.md)
- [PIXBeginRetailEvent function](/ko/reference/tools/pix3/functions/pixbeginretailevent.md)