Skip to main content

​
XAppCaptureMetadataAddStringEvent

Agrega un evento de metadatos con un valor de cadena a la captura de la aplicación.

​
Sintaxis

​
Parámetros

name   _In_z_
Tipo: char* Nombre del evento que se agrega a la escala de tiempo de captura de la aplicación. value   _In_z_
Tipo: char* Valor del evento que se agrega a la escala de tiempo. Debe ser una cadena. priority   _In_
Tipo: XAppCaptureMetadataPriority Prioridad de los metadatos. Se usa para determinar qué se guarda en caso de que se superen los límites de almacenamiento. Un miembro de la enumeración XAppCaptureMetaDataPriority.

​
Valor devuelto

Tipo: HRESULT Resultado de la función.

​
Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
El sistema asocia un evento de metadatos con una marca de tiempo cuando se llama a este método. Estos metadatos se usan para identificar eventos durante las transmisiones en vivo y en la reproducción capturada para categorizar y buscar contenido. Para almacenar un valor de cadena que se aplique a un intervalo de tiempo, use XAppCaptureMetaDataStartStringState.
Los metadatos pueden cargarse en XBOX Live o guardarse en archivos .mp4 y capturas de pantalla, o usarse durante la difusión; por lo tanto, nunca se debe registrar información privada del usuario en los metadatos.

​
Requisitos

Encabezado: XAppCapture.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

​
Documentación conceptual

​
Consulte también

Información general de GameDVR
Miembros de XAppCapture
XAppCaptureMetadataAddDoubleEvent
XAppCaptureMetadataAddInt32Event
Última modificación el 28 de agosto de 2026

Temas relacionados

XAppCaptureMetadataAddDoubleEventXAppCaptureMetadataAddInt32EventAppCaptureMetadataStartStringStateXAppCaptureContenedores de API de C# de Unity para el GDK