Skip to main content

​
AppCaptureMetadataStartStringState

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

​
Sintaxis

​
Parámetros

name   _In_z_
Tipo: char* Nombre del estado que se agrega a la escala de tiempo de captura de la aplicación. value   _In_z_
Tipo: char* Valor del estado 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 limitadores 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 con restricciones de tiempo. Para obtener más información, consulte Subprocesos con restricciones de tiempo.
El sistema asocia un estado de metadatos con el intervalo de tiempo comprendido entre el momento en que se inicia el estado y el momento en que se cambia su valor o se detiene el estado con una llamada a XAppCaptureMetaDataStopAllStates. Estos metadatos se usan para identificar eventos durante las transmisiones en directo y la reproducción capturada, con el fin de categorizar y buscar contenido. Para almacenar un valor de cadena que se aplique a un momento instantáneo en el tiempo, use XAppCaptureMetadataAddStringEvent.
Los metadatos pueden cargarse en XBOX Live o guardarse en archivos .mp4 o capturas de pantalla, o usarse durante la difusión; por tanto, nunca se debe registrar información privada del usuario con 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
Última modificación el 28 de agosto de 2026

Temas relacionados

XAppCaptureMetadataStopStateXAppCaptureMetadataStartInt32StateXAppCaptureMetadataStartDoubleStateXAppCaptureMetadataAddStringEventXAppCaptureMetadataStopAllStates