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

# AppCaptureMetadataStartStringState

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

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

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

## 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](/build/console-features/game-dvr/gamedvr-broadcast)\
[Miembros de XAppCapture](/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureMetadataStopState](/es/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)
- [XAppCaptureMetadataStartInt32State](/es/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
- [XAppCaptureMetadataStartDoubleState](/es/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCaptureMetadataAddStringEvent](/es/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
- [XAppCaptureMetadataStopAllStates](/es/reference/system/xappcapture/functions/xappcapturemetadatastopallstates.md)