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

# XAppCaptureMetadataStartInt32State

> XAppCaptureMetadataStartInt32State

# XAppCaptureMetadataStartInt32State

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

## Sintaxis

```cpp theme={null}
HRESULT XAppCaptureMetadataStartInt32State(  
         const char* name,  
         int32_t 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: int32\_t

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

*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 límites 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 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).

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](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadatastopallstates.md). 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 entero que se aplique a un momento instantáneo en el tiempo, use [XAppCaptureMetaDataAddInt32Event](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md).

> [!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.

## 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](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

- [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)
- [XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [XAppCaptureMetadataStartDoubleState](https://docs.xbox.com/es/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)