Skip to main content

​
XAppCaptureMetadataAddInt32Event

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

​
Sintaxe

​
Parâmetros

name   _In_z_
Tipo: char* Nome do evento que está sendo adicionado à linha do tempo da captura do aplicativo. value   _In_
Tipo: int32_t Valor do evento que está sendo adicionado à linha do tempo. Deve ser um Int32. priority   _In_
Tipo: XAppCaptureMetadataPriority Prioridade dos metadados. Usada para determinar o que é salvo caso os limitadores de armazenamento sejam excedidos. Um membro da enumeração XAppCaptureMetaDataPriority.

​
Valor retornado

Tipo: HRESULT Resultado da função.

​
Comentários

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.
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 inteiro que se aplica a uma janela de tempo, use XAppCaptureMetaDataStartInt32State.
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

​
Confira também

Visão geral do GameDVR
Membros de XAppCapture
XAppCaptureMetadataAddDoubleEvent
XAppCaptureMetadataAddStringEvent
Last modified on October 6, 2026