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

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](https://docs.xbox.com/fr-CA/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 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).

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 double qui s'applique à une période donnée, utilisez [XAppCaptureMetaDataStartDoubleState](https://docs.xbox.com/fr-CA/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md).

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

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

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


## Related topics

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