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

# ID3D12GraphicsCommandList::BeginEvent

> 직접 호출하기 위한 것이 아닙니다. 명령 목록에 이벤트를 삽입하려면 PIX 이벤트 런타임을 사용하세요. (ID3D12GraphicsCommandList.BeginEvent)

직접 호출하기 위한 것이 아닙니다. 명령 목록에 이벤트를 삽입하려면
[PIX 이벤트 런타임](https://devblogs.microsoft.com/pix/winpixeventruntime/)을 사용하세요.

## 구문

```cpp theme={null}
void BeginEvent(
    UINT Metadata,
    const void  pData,
    UINT Size
)
```

### 매개 변수

*Metadata*\
형식: UINT

내부용.

*pData \[in, optional]*\
형식: const void \*

내부용.

*Size*\
형식: UINT

내부용.

### 반환 값

형식: void

없음.

## 설명

이는 PIX 이벤트 런타임에서 내부적으로 사용하는 지원 메서드입니다. 직접 호출하기 위한 것이 아닙니다.

D3D12 명령 목록의 현재 위치에서 계측 영역의 시작을 표시하려면 **PIXBeginEvent** 함수 또는 **PIXScopedEvent** 매크로를 사용하세요. 이들은 [WinPixEventRuntime](https://devblogs.microsoft.com/pix/winpixeventruntime/) NuGet 패키지에서 제공됩니다.

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

[ID3D12GraphicsCommandList](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [BeginQuery](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_beginquery_public.md)
- [PIXBeginEvent reference](/ko/reference/tools/pix3/functions/pixbeginevent_3.md)
- [PIXBeginEvent overview](/ko/reference/tools/pix3/functions/pixbeginevent_4.md)
- [PIXBeginRetailEvent](/ko/reference/tools/pix3/functions/pixbeginretailevent_2.md)
- [PIXBeginRetailEvent function](/ko/reference/tools/pix3/functions/pixbeginretailevent.md)