Skip to main content

​
XAppCaptureMetadataStartInt32State

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

​
Sintaxe

​
Parâmetros

name   _In_z_
Tipo: char* Nome do estado que está sendo adicionado à linha do tempo da captura do aplicativo. value   _In_
Tipo: int32_t Valor do estado 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 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. 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 um momento instantâneo no tempo, use XAppCaptureMetaDataAddInt32Event.
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
Last modified on October 6, 2026