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

# XAppCaptureMetadataAddStringEvent

> XAppCaptureMetadataAddStringEvent

# XAppCaptureMetadataAddStringEvent

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

## Sintaxis

```cpp theme={null}
HRESULT XAppCaptureMetadataAddStringEvent(  
         const char* name,  
         const char* value,  
         XAppCaptureMetadataPriority priority  
)  
```

### 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](/reference/system/xappcapture/enums/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](/reference/system/xappcapture/enums/xappcapturemetadatapriority).

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate).

<Note>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.</Note>

## Requisitos

**Encabezado:** XAppCapture.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[Información general de GameDVR](/build/console-features/game-dvr/gamedvr-broadcast)\
[Miembros de XAppCapture](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureMetadataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)\
[XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)


## Related topics

- [XAppCaptureMetadataAddDoubleEvent](/es/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [XAppCaptureMetadataAddInt32Event](/es/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [AppCaptureMetadataStartStringState](/es/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
- [XAppCapture](/es/reference/system/xappcapture/xappcapture_members.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)