AppCaptureRegisterMetadataPurged

메타 데이터 비우기 이벤트에 대한 이벤트 처리기를 등록합니다.

구문

HRESULT XAppCaptureRegisterMetadataPurged(  
         XTaskQueueHandle queue,  
         void* context,  
         XAppCaptureMetadataPurgedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  

매개 변수

queue _In_opt_
형식: XTaskQueueHandle

비동기 작업을 처리하기 위한 비동기 큐입니다. 할당되지 않은 경우 기본 비동기 큐가 생성됩니다.

context _In_
형식: void*

콜백 함수에 전달할 정보입니다. 일반적으로 호출 개체입니다.

callback _In_
형식: XAppCaptureMetadataPurgedCallback*

비동기 작업이 완료된 후 호출할 콜백 함수입니다.

token _Out_
형식: XTaskQueueRegistrationToken*

이벤트 처리기를 식별하는 토큰입니다.

반환 값

형식: HRESULT

함수 결과입니다.

설명

참고 항목

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

기록 앱 캡처가 지원되기 때문에 캡처 또는 브로드캐스트를 현재 실행 중이 아니어도 AppCaptureMetadataWriter로 기록된 메타 데이터를 시스템이 누적합니다. 예를 들어 이전 30초 동안의 캡처가 디스크에 있는 비디오 파일에 기록될 경우, 녹화된 시간과 연결된 메타 데이터가 파일에 포함됩니다. 시스템은 누적된 메타 데이터 저장을 위해 앱별로 할당되는 저장소 공간에 한도를 지정합니다. RemainingStorageBytesAvailable 속성을 확인하여 현재 사용 가능한 저장소 공간을 확인할 수 있습니다.
할당된 공간이 모두 채워졌으면 오래되고 덜 중요한 데이터를 먼저 삭제하기 위해 각 항목의 사용 기간과 메타 데이터 항목이 기록될 때 지정된 XAppCaptureMetadataPriority 값을 사용하여 시스템이 메타 데이터 비우기를 시작합니다. 이러한 작업이 수행되면 MetadataPurged 이벤트가 발생합니다. 이 이벤트에 대한 응답으로 앱이 기록하는 메타 데이터의 양을 줄이도록 선택할 수 있지만, 필수는 아닙니다.

요구 사항

헤더: XAppCapture.h

라이브러리: xgameruntime.lib

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

참고 항목

GameDVR 개요
XAppCapture 멤버
XAppCaptureUnRegisterMetadataPurged