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

# AppCaptureMetadataStartStringState

> 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](/pt-BR/reference/system/xappcapture/enums/xappcapturemetadatapriority)

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

### 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).</Note>

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](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastopallstates). 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](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent).

<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.</Warning>

## 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](/pt-BR/build/console-features/game-dvr/gamedvr-broadcast)\
[Membros de XAppCapture](/pt-BR/reference/system/xappcapture/xappcapture_members)


## Related topics

- [AppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
- [XAppCaptureMetadataStopState](/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)
- [XAppCaptureMetadataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
- [XAppCaptureMetadataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCaptureMetadataStartInt32State](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)