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

# XAppCaptureMetadataPriority

> XAppCaptureMetadataPriority

# XAppCaptureMetadataPriority

Especifica a importância relativa de um item de metadados de captura do aplicativo armazenado usando o **AppCaptureMetadataWriter**. Quando o espaço de armazenamento alocado para os metadados acumulados estiver baixo, o sistema usará a prioridade e a idade dos itens de metadados para determinar a ordem em que os metadados são removidos para liberar espaço de armazenamento.

## Sintaxe

```cpp theme={null}
enum class XAppCaptureMetadataPriority  : uint8_t  
{  
    Informational = 0,  
    Important,  
}  
```

## Constantes

| Constante | Descrição |
| - | - |
| Informational | Os metadados são informativos e podem ser excluídos primeiro em caso de falta de armazenamento. |
| Important | Os metadados são importantes e serão preservados da exclusão, se possível, em caso de falta de armazenamento. |

## Comentários

A prioridade Important significa que os metadados serão carregados no serviço XBOX Live. Os metadados serão usados para ajudar os usuários a pesquisar clipes ou anotar transmissões, entre outras coisas. Tanto os metadados Important quanto os Informational são inseridos no arquivo .mp4 gerado, portanto, você não deve incluir nenhuma informação privada do usuário nos metadados.

Esta enumeração é usada para atribuir um valor de prioridade aos metadados no momento em que eles são definidos com as seguintes funções:

* [XAppCaptureMetaDataAddDoubleEvent](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)
* [XAppCaptureMetaDataAddInt32Event](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddint32event)
* [XAppCaptureMetaDataAddStringEvent](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent)
* [XAppCaptureMetaDataStartDoubleState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate)
* [XAppCaptureMetaDataStartInt32State](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)
* [XAppCaptureMetadataStartStringState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate)

A prioridade é então levada em consideração ao decidir quais dados excluir, caso uma remoção se torne necessária. A plataforma de captura impõe um limite à quantidade total de metadados que um aplicativo pode adicionar; quando esse limite é atingido, novos eventos ainda serão registrados, mas outros eventos serão excluídos para manter os dados dentro das restrições. Essa exclusão ocorrerá com base no nível de prioridade atribuído a alguns metadados. Os desenvolvedores podem verificar a quantidade de dados restante chamando [XAppCaptureMetaDataRemainingStorageBytesAvailable](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable).

## Requisitos

**Cabeçalho:** XAppCapture.h

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## 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)\
[XAppCaptureMetaDataAddDoubleEvent](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)\
[XAppCaptureMetaDataAddInt32Event](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddint32event)\
[XAppCaptureMetaDataAddStringEvent](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent)\
[XAppCaptureMetaDataStartDoubleState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate)\
[XAppCaptureMetaDataStartInt32State](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)\
[XAppCaptureMetadataStartStringState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate)\
[XAppCaptureMetaDataRemainingStorageBytesAvailable](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable)


## Related topics

- [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [AppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
- [XAppCaptureMetadataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [XAppCaptureMetadataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
