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

# XAppCaptureMetadataStartStringState

> AppCaptureMetadataStartStringState

# AppCaptureMetadataStartStringState

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

## Syntaxe

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

### Paramètres

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

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

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

Valeur de l'état ajouté à la chronologie. Doit être une chaîne.

*priority*   \_In\_\
Type : [XAppCaptureMetadataPriority](https://docs.xbox.com/fr/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)

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](https://docs.xbox.com/fr/reference/system/xappcapture/enums/xappcapturemetadatapriority.md).

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

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](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadatastopallstates.md). 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 de chaîne qui s'applique à un instant précis, utilisez [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md).

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

## 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](https://docs.xbox.com/fr/build/console-features/game-dvr/gamedvr-broadcast.md)\
[Membres de XAppCapture](https://docs.xbox.com/fr/reference/system/xappcapture/xappcapture_members.md)


## Related topics

- [XAppCaptureMetadataPriority](https://docs.xbox.com/fr/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [XAppCaptureMetadataStopState](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)
- [XAppCapture (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xappcapture/xappcapture_members.md)
- [Utilisation des wrappers C# pour les API GDK dans votre projet Unity](https://docs.xbox.com/fr/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)