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

# ID3D12CommandQueue::BeginEvent

> 직접 호출하기 위한 것이 아닙니다. 명령 큐에 이벤트를 삽입하려면 PIX 이벤트 런타임을 사용하세요. (ID3D12CommandQueue.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 제품군

## 함께 보기

[ID3D12CommandQueue](/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)


## Related topics

- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [ID3D12CommandQueue::Signal](/ko/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_signal_public.md)
- [ID3D12CommandQueue::GetDesc](/ko/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_getdesc_public.md)
- [D3D12_COMMAND_QUEUE_DESC](/ko/reference/graphics/d3d12/structs/d3d12_command_queue_desc_public.md)
- [CreateCommandQueue](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandqueue_public.md)