XAppCaptureMetadataAddStringEvent

문자열 값을 갖는 메타 데이터 이벤트를 앱 캡처에 추가합니다.

구문

HRESULT XAppCaptureMetadataAddStringEvent(  
         const char* name,  
         const char* value,  
         XAppCaptureMetadataPriority priority  
)  

매개 변수

name _In_z_
형식: char*

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

value _In_z_
형식: char*

타임라인에 추가되는 이벤트의 값입니다. 반드시 문자열이어야 합니다.

priority _In_
형식: XAppCaptureMetadataPriority

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

반환 값

형식: HRESULT

함수 결과입니다.

비고

참고 항목

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

시스템은 이 메서드가 호출될 때 메타 데이터 이벤트를 타임스탬프와 연결합니다. 이 메타 데이터는 라이브 스트림 중에 이벤트를 식별하기 위해 사용되며, 콘텐츠를 분류 및 검색하기 위해 재생 중에 캡처됩니다. 해당 기간에 적용되는 문자열 값을 저장하려면 XAppCaptureMetaDataStartStringState를 사용합니다.

참고 항목

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

요구 사항

헤더: XAppCapture.h

라이브러리: xgameruntime.lib

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

참고 항목

GameDVR 개요
XAppCapture 멤버
XAppCaptureMetadataAddDoubleEvent
XAppCaptureMetadataAddInt32Event