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

# XAppCaptureMetadataStartDoubleState

> XAppCaptureMetadataStartDoubleState

# XAppCaptureMetadataStartDoubleState

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

## Sintaxis

```cpp theme={null}
HRESULT XAppCaptureMetadataStartDoubleState(  
         const char* name,  
         double 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\_\
Tipo: double

Valor del estado que se agrega a la escala de tiempo. Debe ser un double.

*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 estado de metadatos con el intervalo de tiempo 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 vivo y en la reproducción capturada para categorizar y buscar contenido. Para almacenar un valor double que se aplique a un momento instantáneo en el tiempo, use [XAppCaptureMetadataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent).

Los valores double usados con esta función deben ser finitos. Los double no finitos se convertirán en 0 y se aceptarán.

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


## Related topics

- [XAppCaptureMetadataStopState](/es/reference/system/xappcapture/functions/xappcapturemetadatastopstate.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)
- [XAppCaptureMetadataAddDoubleEvent](/es/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [AppCaptureMetadataStartStringState](/es/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)