다음을 통해 공유


XAppCaptureMetadataStartDoubleState

double 값을 갖는 메타 데이터 상태를 앱 캡처에 추가합니다.

구문

HRESULT XAppCaptureMetadataStartDoubleState(  
         const char* name,  
         double value,  
         XAppCaptureMetadataPriority priority  
)  

매개 변수

name _In_z_
형식: char*

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

value _In_
형식: double

타임라인에 추가되는 상태의 값입니다. 반드시 double이어야 합니다.

priority _In_
형식: XAppCaptureMetadataPriority

메타 데이터의 우선 순위입니다. 저장소 리미터가 초과된 경우에 저장되는 항목을 확인하기 위해 사용됩니다. XAppCaptureMetaDataPriority 열거형의 멤버입니다.

반환 값

형식: HRESULT

함수 결과입니다.

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

시스템은 상태가 시작된 시간과 해당 값이 변경된 시간 또는 XAppCaptureMetaDataStopAllStates에 대한 호출로 상태가 중지된 시간 사이의 기간에 메타 데이터 상태를 연결합니다. 이 메타 데이터는 라이브 스트림 중에 이벤트를 식별하기 위해 사용되며, 콘텐츠를 분류 및 검색하기 위해 재생 중에 캡처됩니다. 시간의 특정 순간에 적용되는 double 값을 저장하려면 XAppCaptureMetadataAddDoubleEvent를 사용합니다.

이 함수에 사용되는 Double 값은 유한해야 합니다. 유한하지 않은 double은 0으로 전환되어 수락됩니다.

주의

메타 데이터가 Xbox Live에 업로드되고 .mp4 파일, 스크린샷에 저장되거나, 브로드캐스트 중에 사용될 수 있으므로, 개별 사용자 정보를 메타 데이터에 기록하지 않아야 합니다.

요구 사항

헤더: XAppCapture.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

GameDVR 개요
XAppCapture 멤버