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