> ## 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\*

ディメンション データ フィールド。

*measurementsJson*   \_In\_opt\_z\_\
型: char\*

測定データ フィールド。

### 戻り値

型: HRESULT

この API 操作の HRESULT 戻り値コード。

## 解説

ディメンションには、有限個の定義済み数値または文字列の値を持つイベント フィールドが含まれます。ディメンションの例: マップ ID、難易度、キャラクターや武器のクラス、ゲーム モード、ブール値の設定など。測定には、スカラー数値メトリックを表すイベント フィールドが含まれます。測定の例: スコア、時間、カウンター、位置など。例: 特定の難易度における試合の最高スコアを追跡するゲーム内イベントの場合、難易度は 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

- [イベント ベースの実績を有効にするためのイベントの書き込み](/ja-jp/services/xbox-services/player-data/achievements/event-based/how-to/live-writing-event-based-achievement.md)
- [イベントの送信](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/events/how-to/live-sending-an-event.md)
- [イベントベース統計を駆動するためのイベントの書き込み](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [Leaderboards](/ja-jp/build/steam-porting-guide/features/steam-leaderboards.md)
- [イベント ベースのステータスの初めての一瞥](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)