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

double 값이 있는 메타데이터 이벤트를 앱 캡처에 추가합니다.

## 구문

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

### 매개 변수

*name*   \_In\_z\_\
형식: char\*

앱 캡처 타임라인에 추가되는 이벤트의 이름입니다.

*value*   \_In\_\
형식: double

타임라인에 추가되는 이벤트의 값입니다. double이어야 합니다.

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

메타데이터의 우선 순위입니다. 저장소 제한을 초과할 경우 무엇을 저장할지 결정하는 데 사용됩니다. [XAppCaptureMetaDataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority) 열거형의 멤버입니다.

### 반환 값

형식: HRESULT

함수 결과입니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

이 메서드가 호출될 때 시스템은 메타데이터 이벤트를 타임스탬프와 연결합니다. 이 메타데이터는 라이브 스트림 중 이벤트를 식별하고 캡처된 재생에서 콘텐츠를 분류 및 검색하는 데 사용됩니다. 특정 시간 구간에 적용되는 double 값을 저장하려면 [XAppCaptureMetaDataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate)를 사용합니다.

이 함수와 함께 사용되는 double 값은 유한해야 합니다. 유한하지 않은 double은 0으로 변환되어 허용됩니다.

<Note>메타데이터는 XBOX Live에 업로드되거나 .mp4 파일, 스크린샷에 저장되거나 방송 중에 사용될 수 있으므로, 개인 사용자 정보는 메타데이터로 기록해서는 안 됩니다.</Note>

## 요구 사항

**헤더:** XAppCapture.h

**라이브러리:** xgameruntime.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 설명서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

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


## Related topics

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