Skip to main content

​
AppCaptureRegisterMetadataPurged

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

​
구문

​
매개 변수

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
마지막 수정일 2026년 8월 24일

관련 항목

XAppCaptureUnRegisterMetadataPurgedXAppCaptureMetadataPurgedCallbackXAppCaptureXAppCaptureMetadataRemainingStorageBytesAvailableXTaskQueueRegistrationToken