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

# XAppCaptureMetadataAddStringEvent

> XAppCaptureMetadataAddStringEvent

# XAppCaptureMetadataAddStringEvent

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

## Syntaxe

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

### Paramètres

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

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

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

Valeur de l'événement 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 événement de métadonnées à un horodatage lorsque cette méthode est appelée. 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 à une période donnée, utilisez [XAppCaptureMetaDataStartStringState](/fr-CA/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate).

<Note>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.</Note>

## 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)\
[XAppCaptureMetadataAddDoubleEvent](/fr-CA/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)\
[XAppCaptureMetadataAddInt32Event](/fr-CA/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)


## Related topics

- [XAppCaptureMetadataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
- [XAppCaptureMetadataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)