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

# XGameEventWrite

> XGameEventWrite

# XGameEventWrite

必要に応じて「dimensions」と「measurement」データ フィールドを含むゲーム内イベントを書き込みます。

## Syntax

```cpp theme={null}
HRESULT XGameEventWrite(  
         XUserHandle user,  
         const char *serviceConfigId,  
         const char *playSessionId,  
         const char* eventName,  
         const char* dimensionsJson,  
         const char* measurementsJson  
)  
```

### Parameters

*user*   \_In\_\
型: XUserHandle

イベントの送信元となるユーザー ハンドル。

\**serviceConfigId*   \_In\_z\_\
型: char

このタイトルの XBOX Live サービス構成 ID (SCID)。

\**playSessionId*   \_In\_z\_\
型: char

プレイ セッション ID。単一のプレイ セッションで送信されるイベントのセットを追跡するために、各ゲーム セッションの開始時にゲームによって作成される一意の GUID です。

*eventName*   \_In\_z\_\
型: char\*

イベント名。

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

JSON 形式の dimensions データ フィールド。

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

JSON 形式の measurement データ フィールド。

### Return value

型: HRESULT

成功した場合は S\_OK を返します。それ以外の場合はエラー コードを返します。エラー コードの一覧については、[エラー コード](/reference/errorcodes)を参照してください。

## Remarks

<Note>この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、[Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) を参照してください。</Note>

Dimensions には、定義済みの有限個の数値または文字列値を持つイベント フィールドが含まれます。dimensions の例: マップ ID、難易度、キャラクターまたは武器のクラス、ゲーム モード、ブール型の設定など。Measurements には、スカラーの数値メトリックを表すイベント フィールドが含まれます。measurements の例: スコア、時間、カウンター、位置など。例: 難易度ごとの最高マッチ スコアを追跡するゲーム内イベントの場合、難易度は dimensions に含め、スコアは measurements に含める必要があります。イベント名、および dimensions と measurements の両方のイベント フィールド名は、タイトルのサービス構成で宣言された名前と一致する必要があります。名前は大文字と小文字を区別しません。この API がサービス構成の名前と一致しない名前でイベントを書き込むと、サービスは通知なしにそのイベントを破棄します。

<Note>Measurements は数値のみを持つことができますが、Dimensions はより多様な型を持つことができます。必要に応じて、*dimensionsJson* フィールドをイベントの書き込みに専用で使用することもできます。</Note>

## Requirements

**ヘッダー:** XGameEvent.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体および XBOX Series 本体

## Conceptual documentation

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[XGameEvent](/reference/system/xgameevent/xgameevent_members)


## Related topics

- [XGameEvent](/ja-jp/reference/system/xgameevent/xgameevent_members.md)
- [XblEventsWriteInGameEvent](/ja-jp/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent.md)
- [PFEventsWriteEventsRequest](/ja-jp/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsrequest.md)
- [PFEventsWriteEventsResponse](/ja-jp/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsresponse.md)
- [PFEventsWriteEventsAsync](/ja-jp/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsasync.md)