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

# XblEventsWriteInGameEvent

> XblEventsWriteInGameEvent

# XblEventsWriteInGameEvent

"dimensions" 및 "measurement" 데이터 필드를 포함하는 인게임 이벤트를 씁니다.

## 구문

```cpp theme={null}
HRESULT XblEventsWriteInGameEvent(  
         XblContextHandle xboxLiveContext,  
         const char* eventName,  
         const char* dimensionsJson,  
         const char* measurementsJson  
)  
```

### 매개 변수

*xboxLiveContext*   \_In\_\
형식: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XBOX Live 컨텍스트 핸들입니다.

*eventName*   \_In\_z\_\
형식: char\*

이벤트 이름입니다. 영숫자 문자만 포함해야 합니다.

*dimensionsJson*   \_In\_opt\_z\_\
형식: char\*

Dimensions 데이터 필드입니다.

*measurementsJson*   \_In\_opt\_z\_\
형식: char\*

Measurement 데이터 필드입니다.

### 반환값

형식: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

## 설명

Dimensions에는 정의된 숫자 또는 문자열 값이 유한한 수의 이벤트 필드가 포함됩니다. Dimensions의 예: 맵 ID, 난이도 수준, 캐릭터 또는 무기 클래스, 게임 모드, 부울 설정 등. Measurements에는 스칼라 숫자 메트릭을 나타내는 이벤트 필드가 포함됩니다. Measurements의 예: 점수, 시간, 카운터, 위치 등. 예: 특정 난이도 수준에 대한 가장 높은 매치 점수를 추적하는 인게임 이벤트의 경우: 난이도 수준은 dimensions에 포함되어야 하며 점수는 measurements에 포함되어야 합니다. 이벤트의 이름과 이벤트 필드의 이름(dimensions 및 measurements 모두)은 타이틀의 서비스 구성에 선언된 이름과 일치해야 합니다. 이름은 대/소문자를 구분하지 않습니다. API가 서비스 구성의 이름과 일치하지 않는 이름의 이벤트를 쓰는 경우 서비스는 알림 없이 이벤트를 삭제합니다. GDK PC 버전을 사용할 때, XGameEvent 기능이 포함된 GRTS 런타임이 설치되어 있어야 하며, 그렇지 않으면 이 함수는 E\_NOTIMPL을 반환합니다.

<Note>Measurements는 숫자 값만 가질 수 있지만 Dimensions는 더 다양한 형식을 가질 수 있습니다. 원하는 경우 *dimensionsJson* 필드만 사용하여 이벤트를 쓸 수 있습니다.</Note>

## 요구 사항

**헤더:** events\_c.h

**라이브러리:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 참고 항목

[events\_c](/reference/live/xsapi-c/events_c/events_c_members)


## Related topics

- [이벤트 전송](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/events/how-to/live-sending-an-event.md)
- [이벤트 기반 업적을 구동하는 이벤트 작성](/ko/services/xbox-services/player-data/achievements/event-based/how-to/live-writing-event-based-achievement.md)
- [이벤트 기반 통계를 구동하는 이벤트 작성](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [이벤트 기반 스탯 첫걸음](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [리더보드](/ko/build/steam-porting-guide/features/steam-leaderboards.md)