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

# AppCaptureMetadataStartStringState

> AppCaptureMetadataStartStringState

# AppCaptureMetadataStartStringState

문자열 값이 있는 메타데이터 상태를 앱 캡처에 추가합니다.

## 구문

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

### 매개 변수

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

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

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

타임라인에 추가되는 상태의 값입니다. 문자열이어야 합니다.

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

시스템은 상태가 시작된 시점과 값이 변경되거나 [XAppCaptureMetaDataStopAllStates](/reference/system/xappcapture/functions/xappcapturemetadatastopallstates) 호출로 상태가 중지된 시점 사이의 시간 구간을 메타데이터 상태와 연결합니다. 이 메타데이터는 라이브 스트림 중 이벤트를 식별하고 캡처된 재생에서 콘텐츠를 분류 및 검색하는 데 사용됩니다. 특정 순간 시점에 적용되는 문자열 값을 저장하려면 [XAppCaptureMetadataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent)를 사용합니다.

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

## 요구 사항

**헤더:** 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)


## Related topics

- [XAppCaptureMetadataStopState](/ko/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)
- [XAppCaptureMetadataStartDoubleState](/ko/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCaptureMetadataStartInt32State](/ko/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
- [XAppCaptureMetadataAddStringEvent](/ko/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
- [XAppCaptureMetadataStopAllStates](/ko/reference/system/xappcapture/functions/xappcapturemetadatastopallstates.md)