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

# XAppCaptureMetadataAddDoubleEvent

> XAppCaptureMetadataAddDoubleEvent

# XAppCaptureMetadataAddDoubleEvent

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

## Syntaxe

```cpp theme={null}
HRESULT XAppCaptureMetadataAddDoubleEvent(  
         const char* name,  
         double 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\_\
Type : double

Valeur de l'événement ajouté à la chronologie. Doit être de type double.

*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 horodatage à un événement de métadonnées 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 et de rechercher du contenu. Pour stocker une valeur double qui s'applique à une plage de temps, utilisez [XAppCaptureMetaDataStartDoubleState](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md).

Les valeurs doubles utilisées avec cette fonction doivent être finies. Les valeurs doubles non finies sont converties en 0 et acceptées.

> [!NOTE]
>
> 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)\
[XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)\
[XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)


## Related topics

- [XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
- [XAppCaptureMetadataStartDoubleState](https://docs.xbox.com/fr/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.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)
