> ## 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 des 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/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 mesure.

### Valeur de retour

Type : HRESULT

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

## Remarques

Les dimensions incluent des champs d'événement comportant 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 incluent des 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 match le plus élevé pour un niveau de difficulté particulier, le niveau de difficulté doit être inclus dans les dimensions et le score dans les mesures. Le nom de l'événement et les noms des champs de l'é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 comportant la fonctionnalité XGameEvent doit être installé, faute de quoi E\_NOTIMPL est renvoyé.

<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/reference/live/xsapi-c/events_c/events_c_members)


## Related topics

- [Envoi d'un événement](/fr/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/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/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/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [Classements](/fr/build/steam-porting-guide/features/steam-leaderboards.md)