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

# XAppCaptureMetadataStartStringState

> AppCaptureMetadataStartStringState

# AppCaptureMetadataStartStringState

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

## Sintaxe

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

### Parâmetros

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

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

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

Valor do estado 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 estado de metadados à janela de tempo entre o momento em que o estado é iniciado e o momento em que seu valor é alterado ou o estado é interrompido com uma chamada para [XAppCaptureMetaDataStopAllStates](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastopallstates.md). 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 um momento instantâneo no tempo, use [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md).

> [!WARNING]
>
> 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)


## Related topics

- [XAppCaptureMetadataPriority](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [XAppCaptureMetadataStopState](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastopstate.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)
- [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)