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

Grava um evento no jogo que, opcionalmente, inclui campos de dados de "dimensões" e "medidas".

## Sintaxe

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

O identificador do usuário em nome de quem o evento será enviado.

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

A ID de configuração de serviço (SCID) do XBOX Live para este título.

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

ID da sessão de jogo. Este é um GUID exclusivo criado pelo jogo no início de cada sessão de jogo para rastrear o conjunto de eventos enviados em uma única sessão de jogo.

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

Nome do evento.

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

Campos de dados de dimensões no formato JSON.

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

Campos de dados de medidas no formato JSON.

### Valor retornado

Tipo: HRESULT

Retornará S\_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de erro](/pt-BR/reference/errorcodes).

## Comentários

<Note>Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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 de arma, modo de jogo, configurações boolianas 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 para um 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 de evento, tanto nas dimensões quanto nas 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.

<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:** XGameEvent.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XGameEvent](/pt-BR/reference/system/xgameevent/xgameevent_members)


## Related topics

- [XGameEventWrite](/reference/system/xgameevent/functions/xgameeventwrite.md)
- [XGameEvent](/reference/system/xgameevent/xgameevent_members.md)