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

Écrit un événement en jeu qui inclut les champs de données « dimensions » et « measurement ».

## Syntaxe

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

### Paramètres

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

Handle de contexte XBOX Live.

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

Nom de l'événement. Ne doit contenir que des caractères alphanumériques.

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

Champs de données de dimensions.

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

Champs de données de mesures.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT de cette opération d'API.

## Remarques

Les dimensions comprennent les champs d'événement ayant un nombre fini de valeurs numériques ou de chaînes définies. Exemples de dimensions : ID de carte, niveau de difficulté, classe de personnage ou d'arme, mode de jeu, paramètres booléens, etc. Les mesures comprennent les champs d'événement qui représentent des métriques numériques scalaires. Exemples de mesures : score, temps, compteurs, position, etc. Exemple : pour un événement en jeu qui suit le score de partie le plus élevé pour un niveau de difficulté donné, le niveau de difficulté doit être inclus dans les dimensions et le score doit être inclus dans les mesures. Le nom de l'événement et les noms des champs d'événement (dimensions et mesures) doivent correspondre aux noms déclarés dans la configuration de service du titre. Les noms ne respectent pas la casse. Si l'API écrit un événement dont le nom ne correspond à aucun nom de la configuration de service, le service abandonne l'événement sans notification. Lors de l'utilisation de la version PC du GDK, un runtime GRTS doté de la fonctionnalité XGameEvent doit être installé, sinon cette fonction renverra E\_NOTIMPL.

<Note>Les mesures ne peuvent avoir que des valeurs numériques, tandis que les dimensions peuvent avoir une plus grande variété de types. Si vous le préférez, le champ *dimensionsJson* peut être utilisé exclusivement pour écrire des événements.</Note>

## Configuration requise

**En-tête :** events\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

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


## Related topics

- [Envoi d'un événement](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/events/how-to/live-sending-an-event.md)
- [Écrire un événement pour alimenter une statistique basée sur les événements](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [Écrire un événement pour alimenter un succès basé sur les événements](/fr-CA/services/xbox-services/player-data/achievements/event-based/how-to/live-writing-event-based-achievement.md)
- [Premier aperçu des statistiques basées sur les événements](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [Classements](/fr-CA/build/steam-porting-guide/features/steam-leaderboards.md)