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

Escribe un evento dentro del juego que opcionalmente incluye campos de datos de "dimensiones" y "mediciones".

## Sintaxis

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

### Parámetros

*user*   \_In\_\
Tipo: XUserHandle

El identificador del usuario en cuyo nombre se envía el evento.

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

El identificador de configuración de servicio (SCID) de XBOX Live para este título.

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

Identificador de sesión de juego. Se trata de un GUID único creado por el juego al inicio de cada sesión de juego para realizar el seguimiento del conjunto de eventos enviados en una única sesión de juego.

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

Nombre del evento.

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

Campos de datos de dimensiones en formato JSON.

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

Campos de datos de mediciones en formato JSON.

### Valor devuelto

Tipo: HRESULT

Devuelve S\_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte [Códigos de error](/reference/errorcodes).

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Las dimensiones incluyen campos de evento con un número finito de valores numéricos o de cadena definidos. Ejemplos de dimensiones: identificador 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 el seguimiento de la puntuación más alta de una partida para un nivel de dificultad: 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 en dimensiones como en 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.

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

## Requisitos

**Encabezado:** XGameEvent.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

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

## Consulte también

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


## Related topics

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