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

# XAppCaptureMetadataStartInt32State

> XAppCaptureMetadataStartInt32State

# XAppCaptureMetadataStartInt32State

Ajoute un état de métadonnées avec une valeur Int32 à votre capture d'application.

## Syntaxe

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

### Paramètres

*name*   \_In\_z\_\
Type : char\*

Nom de l'état ajouté à la chronologie de la capture d'application.

*value*   \_In\_\
Type : int32\_t

Valeur de l'état ajouté à la chronologie. Doit être de type Int32.

*priority*   \_In\_\
Type : [XAppCaptureMetadataPriority](/fr/reference/system/xappcapture/enums/xappcapturemetadatapriority)

Priorité des métadonnées. Permet de déterminer ce qui est conservé en cas de dépassement des limites de stockage. Membre de l'énumération [XAppCaptureMetaDataPriority](/fr/reference/system/xappcapture/enums/xappcapturemetadatapriority).

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d'informations, consultez [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Le système associe un état de métadonnées à la plage de temps comprise entre le démarrage de l'état et le moment où sa valeur est modifiée ou où l'état est arrêté par un appel à [XAppCaptureMetaDataStopAllStates](/fr/reference/system/xappcapture/functions/xappcapturemetadatastopallstates). Ces métadonnées servent à identifier les événements pendant les diffusions en direct et la lecture des captures, afin de catégoriser et de rechercher du contenu. Pour stocker une valeur entière qui s'applique à un instant précis, utilisez [XAppCaptureMetaDataAddInt32Event](/fr/reference/system/xappcapture/functions/xappcapturemetadataaddint32event).

<Warning>Les métadonnées peuvent être chargées sur XBOX Live et/ou enregistrées dans des fichiers .mp4 ou des captures d'écran, ou utilisées pendant une diffusion ; par conséquent, aucune information utilisateur privée ne doit jamais être consignée dans les métadonnées.</Warning>

## Configuration requise

**En-tête :** XAppCapture.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[Vue d'ensemble de GameDVR](/fr/build/console-features/game-dvr/gamedvr-broadcast)\
[Membres de XAppCapture](/fr/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureMetadataStartInt32State](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
- [XAppCaptureMetadataStopState](/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)