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

Escribe un evento dentro del juego que incluye campos de datos de "dimensions" y "measurement".

## Sintaxis

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

### Parámetros

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

Identificador de contexto de XBOX Live.

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

Nombre del evento. Debe contener solo caracteres alfanuméricos.

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

Campos de datos de dimensiones.

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

Campos de datos de mediciones.

### Valor devuelto

Tipo: HRESULT

Código de retorno HRESULT para esta operación de API.

## Comentarios

Las dimensiones incluyen campos de evento con un número finito de valores numéricos o de cadena definidos. Ejemplos de dimensiones: id. de mapa, nivel de dificultad, clase de personaje o de arma, modo de juego, configuraciones booleanas, etc. Las mediciones incluyen campos de evento que representan métricas numéricas escalares. Ejemplos de mediciones: puntuación, tiempo, contadores, posición, etc. Ejemplo: para un evento dentro del juego que realiza un seguimiento de la puntuación más alta de una partida para un nivel de dificultad determinado: el nivel de dificultad debe incluirse en las dimensiones y la puntuación debe incluirse en las mediciones. El nombre del evento y los nombres de los campos del evento (tanto dimensiones como mediciones) deben coincidir con los nombres declarados en la configuración de servicio del título. Los nombres no distinguen mayúsculas de minúsculas. Si la API escribe un evento con un nombre que no coincide con un nombre de la configuración de servicio, el servicio descarta el evento sin ninguna notificación. Cuando se usa la versión para PC del GDK, debe estar instalado un runtime de GRTS con la característica XGameEvent o esto devolverá E\_NOTIMPL.

<Note>Las mediciones solo pueden tener valores numéricos, mientras que las dimensiones pueden tener una variedad más amplia de tipos. Si lo prefiere, el campo *dimensionsJson* puede usarse exclusivamente para escribir eventos.</Note>

## Requisitos

**Encabezado:** events\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Consulte también

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


## Related topics

- [Escritura de un evento para activar un logro basado en eventos](/es/services/xbox-services/player-data/achievements/event-based/how-to/live-writing-event-based-achievement.md)
- [Escritura de un evento para alimentar una estadística basada en eventos](/es/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [Envío de un evento](/es/services/xbox-services/player-data/stats-leaderboards/event-based/events/how-to/live-sending-an-event.md)
- [Primer vistazo a las estadísticas basadas en eventos](/es/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [Tablas de clasificación](/es/build/steam-porting-guide/features/steam-leaderboards.md)