> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCaptureMetadataAddStringEvent

> XAppCaptureMetadataAddStringEvent

# XAppCaptureMetadataAddStringEvent

Adiciona um evento de metadados com um valor de cadeia de caracteres à captura do seu aplicativo.

## Sintaxe

```cpp theme={null}
HRESULT XAppCaptureMetadataAddStringEvent(  
         const char* name,  
         const char* value,  
         XAppCaptureMetadataPriority priority  
)  
```

### Parâmetros

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

Nome do evento que está sendo adicionado à linha do tempo da captura do aplicativo.

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

Valor do evento que está sendo adicionado à linha do tempo. Deve ser uma cadeia de caracteres.

*priority*   \_In\_\
Tipo: [XAppCaptureMetadataPriority](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)

Prioridade dos metadados. Usada para determinar o que é salvo caso os limitadores de armazenamento sejam excedidos. Um membro da enumeração [XAppCaptureMetaDataPriority](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturemetadatapriority.md).

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

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

O sistema associa um evento de metadados a um carimbo de data/hora quando este método é chamado. Esses metadados são usados para identificar eventos durante transmissões ao vivo e na reprodução capturada, para categorizar e pesquisar conteúdo. Para armazenar um valor de cadeia de caracteres que se aplica a uma janela de tempo, use [XAppCaptureMetaDataStartStringState](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md).

> [!NOTE]
>
> Os metadados podem ser carregados no XBOX Live e/ou salvos em arquivos .mp4 e capturas de tela, ou usados durante a transmissão; por isso, informações privadas do usuário nunca devem ser registradas nos metadados.

## Requisitos

**Cabeçalho:** XAppCapture.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

[Visão geral do GameDVR](https://docs.xbox.com/pt-BR/build/console-features/game-dvr/gamedvr-broadcast.md)\
[Membros de XAppCapture](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)\
[XAppCaptureMetadataAddDoubleEvent](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)\
[XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)


## Related topics

- [XAppCaptureMetadataAddDoubleEvent](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [XAppCaptureMetadataStartStringState](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
- [XAppCapture (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)
- [Usar wrappers C# para APIs do GDK no seu projeto do Unity](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)