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

# AppCaptureMetadataStartStringState

> 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](/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 de chaîne qui s'applique à un moment précis dans le temps, utilisez [XAppCaptureMetadataAddStringEvent](/fr-CA/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent).

<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

- [AppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
- [XAppCaptureMetadataStopState](/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)