AppCaptureMetadataStartStringState
문자열 값을 갖는 메타 데이터 상태를 앱 캡처에 추가합니다.
구문
HRESULT XAppCaptureMetadataStartStringState(
const char* name,
const char* value,
XAppCaptureMetadataPriority priority
)
매개 변수
name _In_z_
형식: char*
앱 캡처 타임라인에 추가되는 상태 이름입니다.
value _In_z_
형식: char*
타임라인에 추가되는 상태의 값입니다. 반드시 문자열이어야 합니다.
priority _In_
형식: XAppCaptureMetadataPriority
메타 데이터의 우선 순위입니다. 저장소 리미터가 초과된 경우에 저장되는 항목을 확인하기 위해 사용됩니다. XAppCaptureMetaDataPriority 열거형의 멤버입니다.
반환 값
형식: HRESULT
함수 결과입니다.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
시스템은 상태가 시작된 시간과 해당 값이 변경된 시간 또는 XAppCaptureMetaDataStopAllStates에 대한 호출로 상태가 중지된 시간 사이의 기간에 메타 데이터 상태를 연결합니다. 이 메타 데이터는 라이브 스트림 중에 이벤트를 식별하기 위해 사용되며, 콘텐츠를 분류 및 검색하기 위해 재생 중에 캡처됩니다. 시간의 특정 순간에 적용되는 문자열 값을 저장하려면 XAppCaptureMetadataAddStringEvent32Event를 사용합니다.
주의
메타 데이터가 Xbox Live에 업로드되고 .mp4 파일, 스크린샷에 저장되거나, 브로드캐스트 중에 사용될 수 있으므로, 개별 사용자 정보를 메타 데이터에 기록하지 않아야 합니다.
요구 사항
헤더: XAppCapture.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔