> ## 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-CA/reference/system/xappcapture/enums/xappcapturemetadatapriority)

Priorité des métadonnées. Utilisée pour déterminer ce qui est sauvegardé lorsque les limites de stockage sont dépassées. Un membre de l'énumération [XAppCaptureMetaDataPriority](/fr-CA/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 en toute sécurité sur un thread à délai critique. Pour plus d'informations, consultez [Threads à délai 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 période comprise entre le moment où l'état est démarré et le moment où sa valeur est modifiée ou où l'état est arrêté par un appel à [XAppCaptureMetaDataStopAllStates](/fr-CA/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 le contenu et d'y effectuer des recherches. Pour stocker une valeur entière qui s'applique à un moment précis dans le temps, utilisez [XAppCaptureMetaDataAddInt32Event](/fr-CA/reference/system/xappcapture/functions/xappcapturemetadataaddint32event).

<Warning>Les métadonnées peuvent être téléversées sur XBOX Live et/ou sauvegardées dans des fichiers .mp4 ou des captures d'écran, ou utilisées pendant une diffusion. Par conséquent, les renseignements privés des utilisateurs ne doivent jamais être consignés 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 à délai 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-CA/build/console-features/game-dvr/gamedvr-broadcast)\
[Membres de XAppCapture](/fr-CA/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureMetadataStartInt32State](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
- [XAppCaptureMetadataStopState](/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)
- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [AppCaptureMetadataStartStringState](/es/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)