> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCaptureMetadataStartStringState

> AppCaptureMetadataStartStringState

# AppCaptureMetadataStartStringState

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

## Sintaxis

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

### 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](https://docs.xbox.com/es/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)

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](https://docs.xbox.com/es/reference/system/xappcapture/enums/xappcapturemetadatapriority.md).

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

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

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](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadatastopallstates.md). 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](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md).

> [!WARNING]
>
> 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

* [Subprocesos con restricciones de 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](https://docs.xbox.com/es/build/console-features/game-dvr/gamedvr-broadcast.md)\
[Miembros de XAppCapture](https://docs.xbox.com/es/reference/system/xappcapture/xappcapture_members.md)


## Related topics

- [XAppCaptureMetadataPriority](https://docs.xbox.com/es/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [XAppCaptureMetadataStopState](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)
- [XAppCapture (contenido de la API)](https://docs.xbox.com/es/reference/system/xappcapture/xappcapture_members.md)
- [Uso de contenedores de C# para las API del GDK en el proyecto de Unity](https://docs.xbox.com/es/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)