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

# XAppCaptureMetadataAddDoubleEvent

> XAppCaptureMetadataAddDoubleEvent

# XAppCaptureMetadataAddDoubleEvent

Add a metadata event with a double value to your app capture.

## Syntax

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

### Parameters

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

Name of the event being added to the app capture timeline.

*value*   \_In\_\
Type: double

Value of the event being added to the timeline. Must be a double.

*priority*   \_In\_\
Type: [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority)

Priority of the metadata. Used to determine what is saved in the case that storage limiters are exceeded. A member of the [XAppCaptureMetaDataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority) enumeration.

### Return value

Type: HRESULT

Function result.

## Remarks

<Note>This function isn't safe to call on a time-sensitive thread. For more information, see [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

The system associates a metadata event with a timestamp when this method is called. This metadata is used to identify events during live streams, and captured playback to categorize and search content. To store a double value that applies to a window of time, use [XAppCaptureMetaDataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate).

Double values used with this function must be finite. Non-finite doubles will be converted into 0 and accepted.

<Note>Metadata may be uploaded to XBOX Live and/or saved to .mp4 files, screenshots or used during broadcast, as such, private user info should never be logged with meta data.</Note>

## Requirements

**Header:** XAppCapture.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## Conceptual documentation

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[GameDVR Overview](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture Members](/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)\
[XAppCaptureMetadataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate)


## Related topics

- [XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [XAppCaptureMetadataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
- [XAppCaptureMetadataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)
- [Unity C# API wrappers for the GDK](/build/gdk-and-engines/unity/unity-api-wrappers.md)