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

Grava um evento no jogo que inclui os campos de dados "dimensions" e "measurement".

## Sintaxe

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

### Parâmetros

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

Identificador de contexto do XBOX Live.

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

Nome do evento. Deve conter apenas caracteres alfanuméricos.

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

Campos de dados de dimensões.

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

Campos de dados de medidas.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Comentários

As dimensões incluem campos de evento com um número finito de valores numéricos ou de cadeia de caracteres definidos. Exemplos de dimensões: ID do mapa, nível de dificuldade, classe de personagem ou arma, modo de jogo, configurações booleanas etc. As medidas incluem campos de evento que representam métricas numéricas escalares. Exemplos de medidas: pontuação, tempo, contadores, posição etc. Exemplo: para um evento no jogo que rastreia a maior pontuação de partida em um determinado nível de dificuldade, o nível de dificuldade deve ser incluído nas dimensões e a pontuação deve ser incluída nas medidas. O nome do evento e os nomes dos campos do evento (tanto dimensões quanto medidas) devem corresponder aos nomes declarados na configuração de serviço do título. Os nomes não diferenciam maiúsculas de minúsculas. Se a API gravar um evento com um nome que não corresponda a um nome na configuração de serviço, o serviço descartará o evento sem notificação. Ao usar a versão do GDK para PC, um runtime GRTS com o recurso XGameEvent deve estar instalado; caso contrário, esta chamada retornará E\_NOTIMPL.

<Note>As medidas só podem ter valores numéricos, enquanto as dimensões podem ter uma variedade maior de tipos. Se preferir, o campo *dimensionsJson* pode ser usado exclusivamente para gravar eventos.</Note>

## Requisitos

**Cabeçalho:** events\_c.h

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

## Confira também

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


## Related topics

- [Gravar um evento para alimentar uma estatística baseada em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [Gravando um evento para viabilizar uma conquista baseada em eventos](/pt-BR/services/xbox-services/player-data/achievements/event-based/how-to/live-writing-event-based-achievement.md)
- [Enviar um evento](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/events/how-to/live-sending-an-event.md)
- [Primeiros passos com estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [Placares de líderes](/pt-BR/build/steam-porting-guide/features/steam-leaderboards.md)